Programmare in PHP 

Guida pratica alla programmazione PHP in ambiente GNU/Linux 


Gianluca Giusti brdp @ urcanet.it 


2003 . 07.31 






Gianluca Giusti si è diplomato in Informatica presso l’ITIS de L’Aquila, attualmente frequenta il 
corso di laurea in Fisica presso la Facoltà di Scienze MM.NN.FF dell’Università de L’Aquila 

Lavora come analista programmatore nella città di Roma allo sviluppo di portali, siti di 
commercio elettronico e progetti WEB di vario genere. 

È appassionato di amministrazione di sistema, in particolare GNU/Linux, e di reti informatiche. 


Programmare in PHP 

Copyright © 2001-2003 Gianluca Giusti 

brdp @ urcanet.it 

This information is free; you can redistribute it and/or modify it under thè terms of thè GNU 
General Public License as published by thè Free Software Foundation; either version 2 of thè 
License, or (at your option) any later version. 

This work is distributed in thè hope that it will be useful, but WITHOUT ANY WAR- 
RANTY; without even thè implied warranty of MERCHANTABILITY or FITNESS FOR A 
PARTICULAR PURPOSE. See thè GNU General Public License for more details. 

You should have received a copy of thè GNU General Public License along with this work; if not, 
write to thè Free Software Foundation, Ine., 675 Mass Ave, Cambridge, MA 02139, USA. 


Una copia della licenza GNU General Public License, versione 2, si trova nell’ appendice lAl 


2 



non modificare 



L’indirizzo della versione aggiornata dell’opera "Programmare in PHP" è: 

< h ttp:, "www. urcanet. i t/brdp/ jhp_ manuali/* 

Al momento l’opera è incompleta, tuttavia ho ritenuto opportuno pubblicare quanto fatto. Scri¬ 
vo questo documento nel tempo libero e ultimamente non ne ho molto, quindi, aggiornerò il 
contenuto ogni volta che un argomento sarà completato. 

Gli script di esempio sono contenuti e raggruppati per capitolo all’indirizzo <http://www.urcanet.it/ 
brdp,'ohp_manuaL'ssempi/ > e possono essere testati sul server, mentre, l’archivio completo di tut¬ 
ti gli esempi è prelevabile dalla directory ‘archivio_esempi_scaricabili’ sempre tramite 
l’inidirizzo mostrato sopra. 

L’opera è inclusa in "Appunti di informatica libera" di Daniele Giacomini e disponibile insieme 
ad essa in tutti i suoi mirror. 


La diffusione di questo documento è incoraggiata in base ai termini della licenza. 
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Prefazione 


Questo documento vuole essere una guida all’utilizzo di uno dei più versatili e potenti linguaggi 
di programmazione oggi diffuso in Internet. Il lettore non troverà un elenco delle funzioni del lin¬ 
guaggio, perché sarebbe inutile dal momento che queste notizie sono già disponibili nel manuale 
ufficiale; al contrario, potrà trovare una guida all’utilizzo degli strumenti che gli sviluppatori del 
linguaggio hanno messo a disposizione. 

Naturalmente ognuno potrà ampliare e personalizzare gli script proposti come esempio; sarà la 
guida stessa a sollevare dubbi e a suggerire delle modifiche, per il resto via libera all’immag¬ 
inazione del lettore. Inutile dire che per qualsiasi problema la mia casella di posta è a vostra 
disposizione compatibilmente con gli impegni. 

Per la lettura della guida si darà per scontato: 

• la configurazione corretta della macchina che offre i servizi, in cui devono essere installati il 
servente HTTP (negli esempi di questa guida si fa riferimanto principalmente ad Apache), il 
modulo PHP 4 e una base di dati (DBMS), che negli esempi proposti è costituita da MySQL; 

• la conoscenza del linguaggio HTML; 

• un minimo di conoscenza del linguaggio SQL per l’interrogazione delle basi di dati di prova. 

Verranno risolti i problemi più comuni, progettati e realizzati i servizi necessari a un sito per 
essere moderno, dinamico e al passo coi tempi. Si pensi alla gestione di utenze, aree riservate, 
notizie, sondaggi, motori di ricerca, album fotografici, servizi FTP, ecc. 

Per fare questo si partirà da esempi molto semplici, scritti in modo altrettanto semplice, fino ad 
arrivare alla realizzazione di «classi» da utilizzare in tutti i nostri servizi. 

Prima di iniziare converrà collegarsi al sito <http://www.php.net> per scaricare il manuale ufficiale 
del PHP; sarà molto utile ed è importante saperlo consultare. Viene rilasciato in vari formati; 
probabilmente il più conveniente è il formato PDF. In tal modo, si disporrà di un unico file su 
cui poter effettuare ricerche di testo. Inoltre è importante ricordare che un gruppo di persone sta 
traducendo il manuale in italiano ospitato sul sito ufficiale all’indirizzo <http://www.php.net/manual/ 
it/>. Chi volesse partecipare può mettersi in contatto con i coordinatori del progetto Luca Perugini 
Simone Cortesi. 
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Capitolo 


Prima di addentrarsi nella programmazione, è bene capire quali sono gli strumenti a disposizione 
e cosa permettono di fare. C’è molto interesse verso le tecnologie utilizzate in Internet, di con¬ 
seguenza si crea spesso confusione. Una delle conseguenze più frequenti è ostinarsi a utilizzare 
un linguaggio nato con uno scopo per realizzare tutt’altro. 

1.1 Cos'è il PHP? 


PHP sta per Hypertext Preprocessor. Dalla documentazione ufficiale il PHP viene definito come 
un «linguaggio script dal lato del servente immerso nel codice HTML». Di seguito la definizione 
nel dettaglio: 

«linguaggio script»: il PHP è un vero e proprio linguaggio di programmazione, è importante 
rendersi conto che l’HTML, ad esempio, non è un linguaggio di programmazione ma un linguag¬ 
gio di descrizione e formattazione del testo. Inoltre, per i più esperti, il PHP è un linguaggio 
interpretato. 

«Dal lato del servente»: queste le parole fondamentali. Il codice PHP inserito tra i marcatori 
HTML viene interpretato dall’elaboratore servente e non dal navigatore del cliente. Il modo 
migliore per rendere l’idea è passare ad un esempio. 

Figura o Il servente elabora tramite l'interprete PHP gli script i quali generano le 
pagine HTML che vengono fornite al cliente tramite il protocollo HTTP. 


E1aboratore 
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Elaboratori clienti 


Si supponga di voler scrivere la data odierna in una pagina HTML. L’HTML non permette di far¬ 
lo, in quanto, è un linguaggio di formattazione statico. Una soluzione potrebbe essere l’utilizzo di 
uno script Java di Netscape (JavaScript) ma è un linguaggio lato cliente. Il codice JavaScript viene 
eseguito dal navigatore del visitatore e non dal servente. Tutto ciò potrebbe portare alla visualiz¬ 
zazione di una data errata sulle pagine del sito solo perchè l’orario di sistema del visitatore non è 
impostato correttamente. Inoltre la guerra per il monopolio nel mercato dei navigatori ipertestuali 
tra Microsoft e Netscape ha fatto sì che non ci sia uno standard, di conseguenza Netscape non 
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gestiste molte istruzioni JScript di Microsoft e Explorer non riconosce molte istruzioni JavaScript 
di Netscape^. 

A questo punto l’ideale è fornire al navigatore una stringa HTML generata e formattata da una 
funzione PHP. Ecco come: 

1 <html> 

2 <head> 

3 <title>La mia prima pagina php</title> 

4 </head> 

5 <body> 

6 

7 <brxbr> 

8 

9 <?php echo date("d-m-Y") ?> 

10 

11 <brxbr> 

12 

13 <a href="../cap_2/benvenuto,php">vai a benvenuto.php &gt;&gt;</a> 

14 

15 </body> 

16 </html> 


Una volta completato salvare il codice nel file ‘primo.php’. 

Se si prova ad aprire ‘primo. php’ dal menù file del navigatore il risultato è una pagina bianca. 
Il motivo sta nel fatto che il PHP è un «linguaggio dal lato del servente» dunque il navigatore 
(cliente) non è in grado di interpretarne il codice compreso tra i marcatori: ‘<?php ?>’ 

Per visualizzare la data in modo corretto è necessario dare il codice in pasto all’interprete PHP 
tramite il servente HTTP, quindi bisogna copiare il file ‘primo. php’ nella directory dei documen¬ 
ti del servizio HTTP e dal navigatore richiamare il file scrivendo l’indirizzo dell’elaboratore su 
cui è ospitato. Tutti gli script di esempio sono disponibili in rete all’indirizzo <http://www.urcanet.it/ 
brdp/php_manual/;sempi/> e sono raccolti per capitolo. 

Se si scaricano gli script di esempio per essere eseguiti in locale e la configurazione del servente 
è corretta, il risultato sarà: 

Figura fTT2l Ecco come appare la pagina HTML <http:/' Mfiw.urcanet.it/ordp/php_manuai/ 
esempi/cap_h'primo.php> sul navigatore del visitatore. 



Ben più interessante è osservare il sorgente della pagina <http://www.urcanet.it'brdp/ohp_manual/;sempi/ 
cap_l/orimo.php> dal menu visualizza del navigatore, ecco quello che viene inviato dal servente: 

1 Netscape ha sviluppato un linguaggio di programmazione ad oggetti interno al navigatore chiamato JavaScript tramite 
il quale è possibile gestire le finestre del navigatore, i form di invio dati, la navigazione stessa delle pagine e tanto ancora. 
La Microsoft per il proprio navigatore Explorer ha realizzato un linguaggio molto simile chiamato JScript. Purtroppo i 
due linguaggi non sono compatibili al 100% anche se le istruzioni di base sono ben gestite da entrambi. 
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Figura[T3] L'interprete PHP ha fatto il suo dovere, Questo è il codice generato e fornito 
al navigatore tramite il servente HTTP. 



Una volta ricevuta la richiesta della pagina da parte del navigatore, il servente inizia a leggere 
il file ‘primo.php’ e a inviarlo al cliente, appena trovati i marcatori ‘<?php ?>’ capisce che 
deve farsi «tradurre» il codice in essi contenuto. Lo passa quindi all’interprete PHP che lo es¬ 
egue e restituisce il risultato. In questo semplice esempio il risulato dell’operazione è la stringa 

‘ 23 - 03 - 2002 ’. 

La funzione utilizzata nell’esempio ‘date ( "d-m-Y" ) ’ formatta la data nello schema giorno- 
mese -anno (numerico), mentre ‘echo’ visualizza a schermo il risultato della funzione ‘date ( ) ’. 

Una modifica interessante al file precedente è: 

1 <html> 

2 <head> 

3 <title>La mia prima pagina php</title> 

4 </head> 

5 <body> 

6 

7 <brxbr> 

8 

9 <?php phpinfo() ?> 

10 

11 <brxbr> 

12 

13 <a href="../cap_2/benvenuto.php">vai a benvenuto.php &gt;&gt;</a> 

14 

15 </body> 

16 </html> 

Questa volta il risultato è una pagina che visualizza la configurazione dell’elaboratore servente , 
dell’interprete e dei componenti per l’interrogazione delle basi di dati, oltre a una serie di variabili 
predefìnite. È bene dare un’occhiata al sorgente HTML della pagina, tutta opera dell’interprete 
PHP. 

«immerso nel codice HTML»: con ciò si intende che quanto contenuto tra i marcatori ‘<?php ?>’ 
viene prima interpretato, e poi inviato al navigatore come semplice codice HTML insieme al resto 
della pagina. 
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1.2 Cosa può fare il PHP? 

Dunque il PHP permette di rendere dinamiche le pagine HTML dal lato del servente. Questo 
insieme alla sua semplicità di utilizzo, alla somiglianza con la sintassi C e alle innumerevoli 
funzioni che permettono di interagire con basi di dati e servizi di ogni genere ne hanno decretato 
il successo in Internet. 

La diffusione è dovuta alla semplicità di configurazione e alla completa compatibilità con nu¬ 
merosi serventi HTTP. Per il test degli script di questa guida è stato utilizzato come servente 
Apache. ^ 

Il PHP permette, in modo semplice e diretto, di far interagire il cliente con le basi di dati ospitate 
sul servente tramite il semplice utilizzo di un comune navigatore. 

Tutti i maggiori DBMS sono gestiti da PHP, senza dover installare software aggiuntivo o 
commerciale. Un breve elenco è riportato nella tabella [Lll 

Tabella Qj] Queste le basi di dati gestite dal PHP. 


BASI DI DATI 

Adabas D 

InterBase 

PostgreSQL 

dBase 

FrontBase 

Solid 

Empress 

mSQL 

Sybase 

FilePro (read-only) 

Direct MS-SQL 

Velocis 

IBM DB2 

MySQL 

Unix dbm 

Informix 

ODBC 

Ingres 

Oracle (OCI7 and OCI8) 




Inoltre il PHP permette di interagire con numerosi servizi tramite i protocolli: IMAP, SNMP, 
NNTP, POP3, HTTP e molti altri. 

1.3 PHP su piattaforma Microsoft 

Il PHP è compatibile con molte piattaforme di sviluppo, tra cui quella Microsoft. Ovviamente le 
migliori prestazioni si ottengono in ambiente GNU/Linux (o più in generale su sistemi Unix). 

Per informazioni più dettagliate si rimanda al sito ufficiale <http://www.php.net>. 

1.4 Quanto costa il PHP? 

Il PHP viene distribuito nei termini della: The PHP License, version 2.02. 

I requisiti minimi richiesti alTeleboratore servente sono del tutto abbordabili. Per i test degli script 
contenuti in questa guida è stato utilizzato un vecchio P-120MHz con soli 16 Mibyte di RAM e 
un piccolo disco fisso da 1,2 Gibyte. 

Su di esso è stata installata una versione Debian GNU/Linux 2.2 con servente Apache, MySql, 
interprete PHP4. Sulla stessa macchina erano in esecuzione il servente FTP, PostgreS QL, Postfix 
e altri servizi minori. 


Programmare in PHP — Copyright © 2001-2003 Gianluca Giusti — brdp @ urcanet.it 
2 È possibile prelevare Apache dal sito ufficiale <http://www.apache.org>. 
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Le basi del linguaggio 

Per poter scrivere codice in un qualunque linguaggio è necessario conoscerne la sintassi. In questo 
capitolo verranno trattate le espressioni fondamentali del PHP con il supporto di script di esempio. 

2.1 La sintassi 

In realtà ‘<?php ?>’ non sono gli unici marcatori per fornire codice all’interprete. Ecco tutti i 
modi di includere codice PHP negli script: 

• < ? codice ? > 

• <?php codice ?> 

• <script language="php"> codice </script> 

• <% codice %> 


Il primo è disponibile solo se sono stati impostati i marcatori abbreviati, ciò può essere fatto 
abilitando nel file di configurazione ‘php.ini’ l’opzione ‘short_open_tag’. Per i particolari 
sugli altri marcatori si rimanda al manuale ufficiale. 

Va sottolineato che il codice può essere bloccato e ripreso in ogni punto dello stesso file, ad 
esempio: 

1 <html> 

2 <head> 

3 

4 <? $nome = "BRDP"; ?> 

5 <title>ancora agli inizi</title> 

6 

7 </head> 

8 <body> 

9 

10 <br>Ciao a tutti questo è il mio nome: <?=$nome ?> 

11 

12 </body> 

13 </html> 

Nell’esempio il codice viene aperto per la prima volta nella riga 4, viene assegnato un valore alla 
variabile ‘$nome’, viene chiuso e poi riaperto nella riga 10 dove viene visualizzato a schermo il 
valore della variabile insieme a una frase HTML. Il file quindi restituirà come output la stringa: 

Ciao a tutti questo è il mio nome: BRDP 

Con l’occasione, nell’esempio, sono stati toccati due concetti base. 

Il primo è che le variabili in PHP iniziano con il carattere '$’ e sono sensibili a maiuscole e 
minuscole, l’altro è che non è necessario definirne il tipo, sarà quello del primo dato ad essa 
assegnato. Nel nostro caso la variabile ‘$nome’, dalla riga 4 in poi, sarà considerata una stringa. 
Per averne conferma basta sostituire il codice della riga 4 con le due righe seguenti: 

4 <? 

5 $nome = "BRDP"; 

6 echo gettype($nome); 

7 ?> 


12 
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string 

Ciao a tutti questo è il mio nome: BRDP 

Più avanti si apprenderà come trattare i vari tipi di dati, quindi è inutile dilungarsi in questo 
esempio; bisogna però dire che è possibile cambiare il tipo di dati mediante l’istruzione: 

settype($variabile, tipo_variabile); 


e ottenere il tipo di dato contenuto in una variabile tramite: 

gettype($variabile) ; 


Il secondo concetto è nella riga 10; per visualizzale il contenuto della variabile è stata utilizzata 
la sintassi: 

<?=$nome ?> 


Per chi si avvicina al PHP dopo aver sviluppato in Perl o in altri linguaggi script CGI la dif¬ 
ferenza è lampante. Non è necessario scrivere codice per generare HTML, semplicemente si in¬ 
serisce codice PHP tra i marcatori HTML. Inoltre nel caso in cui l’istruzione sia la semplice 
visualizzazione di una singola variabile, la sintassi classica: 

<? echo $nome ?> 

può essere abbreviata con: 

<?=$nome ?> 


Attenzione: se il codice PHP è formato da più istruzioni consecutive è richiesto il carattere punto 
e virgola (‘; ’) alla fine di ognuna di esse, se invece l’istruzione da inserire è una sola, il ‘ ’ può 
essere omesso. 

Sarebbe buona norma dedicare molta cura all’indentazione del codice e inserire commenti chiari 
e diretti; così facendo si rende il codice più leggibile e comprensibile. La gestione dei commenti è 
simile a quella utilizzata in C, C++ e shell di Unix. I caratteri di commento sono: per una singola 
riga ‘//’ la barra obliqua doppia oppure il carattere ‘#’, per più righe il commento viene aperto 
con ‘/*’ e chiuso con ‘*/’. Nel secondo caso bisogna fare attenzione a non annidare i commenti. 
Questo è il modo corretto: 


o 

ì 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 


// Questo è un commento su una singola riga 
// adesso visualizzo ciao mondo! 

echo "ciao mondo!"; 

/* 

questo è un commento 

su più righe, posso scrivere di tutto! ! ! 

anche istruzioni php che non verranno interpretate come: 
echo "questo non verrà visualizzato!"; 
chiudo il commento 

*/ 


echo "<br>questo invece si vedrà!!"; 
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15 

16 /* 

17 Notare che ho inserito <br> un marcatore html nel 

18 codice php! Posso farlo. 

19 */ 

20 ?> 


Questo è sbagliato: 

o <? 

ì 

2 /* 

3 echo "ciao mondo!"; /* questo causa problemi! */ 

4 */ 

5 

6 ?> 


2.2 Primo script 

Come primo esempio verrà realizzata una pagina di riconoscimento del visitatore. Il PHP fornisce 
una serie di «variabili predefinite». Tra esse ce ne sono alcune fornite dal protocollo HTTP. 

Per l’elenco completo delle variabili predefinite è bene consultare il manuale ufficiale del PHP, 
molte di esse vengono visualizzate nella pagina generata dalla funzione ‘phpinfo () 

Il primo passo è scegliere le variabili da utilizzare. 

Per questo semplice script verranno utilizzate: 

• ‘SERVER_NAME ': nome dell’elaboratore su cui risiede e viene eseguito lo script; 

• ‘HTTP_REFERER’ : PURI, se ne esiste uno, da cui proviene il visitatore;® 

• ’HTTP_USER_AGENT’: il tipo di navigatore utilizzato dal visitatore; 

• ’REMOTE_ADDR’: l’indirizzo IP dell’elaboratore cliente; 

• "SCRIPT_NAME': il percorso dello script in esecuzione; 


è importante fare molta attenzione all’utilizzo di queste variabili, alcune di esse usate 
in modo superficiale potrebbero fornire informazioni utili ai malintenzionati. Ad esempio 
’DOCUMENT_ROOT’ fornisce la directory su file System in cui si trovano gli script PHP e i 
documenti del servizio HTTP. Informazioni di questo tipo è meglio tenerle riservate! 


Scelte le variabili va creato il nuovo file e salvato con il nome di ‘benvenuto.php’. La prima 
versione, la più rudimentale, è la seguente: 

1 <html> 

2 <head> 

3 <title>Benvenuto!</title> 

4 </head> 

5 <body> 

6 

*Nel caso in cui il servente sia Apache, le variabili HTTP nella pagina 'phpinfo () ’ vengono raccolte nella sezione 
«variabili di Apache» 

2 Se si segue il percorso degli script proposti dalla guida, il visitatore arriverà da <http. "xww. urcanct. it'jrdp.' ihp_manual/ 
esempi. '■ :ap_ l.\ nimo.php > 




Le basi del linguaggio 


15 


7 <br> La mia prima vera pagina in PHP.<br><hr> 

8 

9 <brxbr> Informazioni sul server: 

10 <br>Sei giunto su: <?=$SERVER_NAME ?> 

12 <br>Stai eseguendo lo script: <?=$SCRIPT_NAME ?> 

13 

14 <brxbr> Esaminiamo il Client: 

15 

16 <br> Indirizzo IP: <?=$REMOTE_ADDR ?> 

17 <br> Vedo che provieni da: <?=$HTTP_REFERER ?> 

18 <br> Tipo di browser: <?=$HTTP_USER_AGENT ?> 

19 

20 </body> 

21 </html> 

Salvato il file nella directory del servizio HTTP e richiamato dal navigatore si ottiene qualcosa 
simile a: 

La mia prima vera pagina in PHP. 

Informazioni sul server: 

Sei giunto su: www.urcanet.it 

Stai eseguendo lo script: /brdp/php_manual/esempi/cap_2/benvenuto.php 

Esaminiamo il Client: 

Indirizzo IP: 127.0.0.1 

Vedo che provieni da: http://www.urcanet.it/brdp/php_manual/esempi/cap_l/primo.php 
Tipo di browser: Mozilla/5.0 (Xll; U; Linux 2.4.2-2 i686; en-US; 0.7) Gecko/20010316 


Anche questo esempio è disponibile in rete all’indirizzo: <http://www.urcanet.it'brdp/php_manual,'isempi/ 
cap_2/benvenuto.php> 

Il risultato potrebbe essere incomprensibile per i visitatori meno esperti. Ad esempio, il tipo di 
navigatore non è molto chiaro. 

Gli strumenti fin qui trattati non permettono di fare molto per migliorare il risultato dello script. 
Più avanti questo esempio potrà essere ripreso per manipolare il risultato in modo da mostrare al 
visitatore dei messaggi più chiari. 

2.3 Tipi di dati 

Il PHP gestisce quattro tipi scalari, due tipi composti e due tipi speciali di dati. 

TabellaETI Questi i tipi di dati gestiti dal PHP. 


Scalari 

Composti 

Speciali 

‘boolean’ 

‘array’ 

‘resurce’ 

‘integer’ 

ob ject" 

‘NULL’ 

‘doublé’ 



’string" 




Come già accennato in precedenza, il tipo di una variabile può essere modificato in ogni momento 
con la funzione ‘settype ($variabile, tipo) ’ che restituisce un valore booleano vero o falso 
rappresentante l’esito dell’operazione. I possibili tipi da assegnare alla variabile sono: 

• ‘integer’ 


• "doublé’ 
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‘string’ 
‘array’ 
‘object’ 
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I criteri di conversione dei tipi sono molto importanti, il codice mostrato di seguito non provoca 
problemi. 

o <? 

1 $a = 231; //da questo momento in poi $a è un intero 

2 if(settype($a,doublé)){ 

3 /* 

4 Se l'operazione è riuscita il valore è TRUE quindi 

5 visualizza il testo seguente. Altrimenti salta alla 

6 fine dell'if riga 10. 

7 */ 

8 echo "<br>valore settato a doublé. Ecco il nuovo valore: "; 

9 echo $a; 

10 } 

11 ?> 


Spiacevoli inconvenienti potrebbero verificarsi se si prova a convertire una stringa in un intero. 
Per una trattazione più approfondita di questo argomento si rimanda al manuale ufficiale. 

Un’altra funzione utile per la gestione dei tipi di dati è ‘gettype ($variabile) ’ che restituisce 
una stringa contenente il tipo della variabile a essa fornita. Questi i possibili valori restituiti dalla 
funzione: 


• ‘integer’ 

• ‘doublé - 

• ‘string’ 

• ‘array’ 

• ‘object’ 

• ‘unknown type’ 


Ecco un semplice esempio di utilizzo della funzione ‘gettype () ’: 

o <? 

1 $a = "brdp"; 

2 /* 

3 la variabile $a è stata 

4 inìzializzata come stringa 

5 */ 

6 $tipo_a = gettype($a); 

7 echo "<br>La variabile è dì tipo:"; 

8 echo $tipo_a; 

9 ?> 


Il risultato dello script sarà: 

La variabile è di tipo: string 


Dopo questa breve trattazione sulla gestione dei tipi di dati a disposizione nel PHP, è bene 
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2.3.1 integer 


Il tipo di dati ‘integer’ rappresenta tutti i numeri dell’insieme matematico degli interi. 
z = {..., - 2 , - 1 , 0 , 1 , 2 , .. .} 


Quindi tutti i numeri interi, sia negativi che positivi, vengono gestiti dal PHP come tipi 

‘integer’. 

Anche i corrispondenti valori in base otto e sedici vengono gestiti come gli interi. Ecco alcuni 
esempi tratti dal manuale ufficiale: 

<? 


$a = 

1234; 

// 

numero 

intero positivo 


$a = 

-123; 

// 

numero 

intero negativo 


$a = 

0123; 

// 

numero 

ottale (equivalente a 83 

in decimale) 

$a = 

OxlA; 

// 

numero 

esadecìmale (equivalente 

a 26 in decimale) 


Il limite massimo della dimensione dei valori interi dipende dall’architettura dell’elaboratore su 
cui si lavora. 

Nel PHP non esiste un tipo specifico per i numeri naturaliPrissi vengono gestiti come ‘integer’. 

2.3.2 boolean 

Il tipo di dati ‘boolean’ può assumere solo due valori, vero o falso. 

Questo tipo viene utilizzato frequentemente per la gestione degli errori. Molte funzioni, infatti, 
restituiscono un valore booleano che assume valore vero se l’operazione è andata a buon fine, 
falso se si è verificato un errore. 

Per assegnare il valore vero o falso a una variabile è sufficiente l’istruzione: 

$bit = True; 


In questo esempio alla variabile ‘$bit’ è stato assegnato il valore vero. Anche se l’istruzione 
‘if’ non è ancora stata trattata, è necessario anticipare le metodologie di controllo sul valore 
della variabile. 

In PHP non è necessario (anche se è possibile) eseguire il controllo in questo modo: 

<? 

$bit = True; 

if($bit == "True"){ 

// $bit è vero 

echo " il valore è vero!"; 

} 

?> 


Basta scrivere: 


3 I numeri naturali sono il sottoinsieme positivo dei numeri interi. 
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$bit = True; 

if($bit){ 

// $bit è vero 

echo " il valore è vero!"; 

} 


L’inteiprete riconosce il tipo di dato e controlla se è vero. Nei prossimi capitoli verranno 
approfondite le caratteristiche dell’istruzione ‘if’. 


2.3.3 doublé 


Come è stato più volte ripetuto, il PHP non necessita della definizione dei tipi di dati che si 
vanno a utilizzare ma inizializza il tipo di variabile in base al primo valore a essa associato. I 
«numeri a virgola mobile» in PHP contengono i tipi conosciuti in altri linguaggi come: ‘f loats’, 
‘doubles’, ‘reai’. È possibile inizializzare una variabile di tipo ‘doublé’ assegnandole valori 
formattati in uno dei seguenti modi: 

<? 

$a = 1.234; 

$a = 1.2e3; 

$a = 7E-10; 

?> 


Anche per questo tipo, come per gli interi, la dimensione massima dipende dall’architettura 
dell’elaboratore su cui viene eseguito lo script. 


2.3.4 string 


Una stringa è un insieme di caratteri. In PHP non ci sono limiti particolari di lunghezza per i dati 
di tipo ‘string’. 

Ci sono più modi di delimitare una stringa. Ecco i due più comuni: 

o <? 

1 // single quoted string 

2 $nome = 'Gianluca Giusti'; 

3 

4 // doublé queoted string 

5 $nome = "Gianluca Giusti"; 

6 

7 /* In entrambi i casi $nome viene inizializzata 

8 come stringa dall'interprete PHP */ 

9 ?> 


L’interprete PHP riconosce come carattere di escape il ‘V (barra obliqua inversa).^ 

Di seguito riportiamo i caratteri più comuni, una tabella completa è contenuta nel manuale 
ufficiale. 


4 I1 carattere di escape viene utilizzato per rappresentare caratteri speciali all’interno di una stringa, caratteri che 
potrebbero creare confusione all’interprete. 
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Tabella |Z2] Alcuni caratteri di escape per le stringhe PHP. 


Carattere 

Significato 

\t 

carattere tabulazione 

\n 

carattere di fine riga 

\\ 

‘ V barra obliqua inversa 

\" 

‘ " " doppio apice 

\s 

‘$‘ dollaro 


Ecco alcuni esempi di come gestire le stringhe. 


o 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 


<? 

// Valorizzo una variabile che servirà in seguito. 

$email = " brdp @ urcanet.it 

// Stringa semplice: 

$stringa = "Ecco. Questa è una stringa"; 

// Ad essa si possono concatenare altre stringhe alla fine 
$stringa = $stringa." con dell'altro testo aggiunto"; 

// che equivale a scrivere 

$stringa .= " con dell'altro testo aggiunto"; 

// Oppure all'inizio 

$stringa = "altro testo ancora ".$stringa; 

// Adesso si prende la prima lettera della stringa 
$prima = $stringa{0}; 

// Concatenazione multipla 

$stringa = $prima." - ".$stringa." <brxbr> il mio email: ",$email; 


/ 


$ 


* Test sui caratteri di escape. All'interno della 
visualizzare il valore di una variabile ma per 
il nome devo "inibire" il carattere speciale $. 
l'uso della barra obliqua inversa. Ecco come: * 
stringa = "Questo il valore di \$email: $email"; 


stringa posso 
visualizzarne 
Lo faccio con 

/ 


// c'è differenza con: 

$stringa = "Questo il valore di $email: $email"; 
?> 


L’esempio precedente non è completo. Per poter osservare i risultati delle varie operazioni a 
schermo è necessario modificare lo script. Questo semplice, ultimo passo è lasciato al lettore 
come esercizio. 

Il PHP fornisce un gran numero di funzioni dedicate alla gestione delle stringhe; uno dei punti di 
forza di questo linguaggio sta proprio nella semplicità con cui queste possono essere manipolate. 
Risulta inutile dilungarsi nella trattazione delle singole funzioni, esse verranno descritte negli es¬ 
empi in cui saranno impiegate. Un elenco completo e dettagliato è contenuto nel manuale ufficiale 
alla sezione «String functions». 
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2.3.5 array 

Gli array possono essere creati tramite il costrutto "array () ’ oppure tramite la valorizzazione 
degli elementi. 

A differenza dei classici linguaggi di programmazione, il PHP permette di indicizzare gli ar¬ 
ray non solo mediante interi non negativi, ma anche tramite stringhe. Per chi conosce il Perl il 
concetto è molto simile a quello degli array associativi. 

Di seguito la sintassi per creare un array tramite il costrutto ‘array () ’. 

o <? 

1 array( [chiave =>] valore 

2 , . . . 

3 ) 

4 // la chiave può essere un intero non negativo o una stringa 

5 // il valore può essere qualunque 

6 ?> 

La chiave è contenuta tra le parentesi quadre perchè può essere omessa, se non viene specificata 
viene incrementato il valore intero. La sintassi di associazione è molto semplice ed intuitiva, per 
le chiavi intere positive: ‘ chiave => valore ’, mentre per le chiavi di tipo stringa vanno aggiunte 
le doppie virgolette '"chiave" => valore ’. 

Per visualizzare il contenuto dell’array è possibile utilizzare la semplice istruzione 
‘print_r ($array) ’. Negli esempi seguenti si vedrà come questa funzione visualizza l’array. 

Ecco alcuni esempi. 

o <? 

1 $a = array( "a", "b", 44, "d", "e"); 

2 prìnt_r($a); 

3 ?> 

L’istruzione ‘print_r ($a) ’ visualizzerà sullo schermo la struttura e il contenuto dell’array nel 
seguente modo: 

Array ( [0] => a [1] => b [2] => 44 [3] => d [4] => e ) 

L’indice dei valori è stato incrementato automaticamente. È bene tenere sempre presente che le 
chiavi degli array partono da 0 e non da 1. 

C’è la possibilità di specificare solo alcune chiavi e lasciare la gestione degli indici omessi 
all’interprete. 

o <? 

1 $a = array( "a", "b", "c", "d", 8=>"e", 4=>"f", "g", 3=>"h"); 

2 print_r($a); 

3 ?> 

Questo il risultato dello script precedente: 

Array ( [0] => a [1] => b [2] => c [3] => h [8] => e [4] => f [9] => g ) 

A prima vista il risultato può sembrare errato, ma non è così. L’interprete incrementa automatica- 
mente gli indici omessi dei primi quattro valori, ossia da 0 a 3, e mano a mano valorizza l’array. 
La lettera e' va invece inserita nella cella con chiave, specificata, pari a 8 e la ‘f’ in quella con 
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chiave 4. Per la lettera ‘g’ non viene specificata nessuna chiave, l’interprete, quindi, riparte au¬ 
tomaticamente dall’indice intero più alto incrementandolo di uno e ottiene il valore 9. Rimane 
da inserire l’ultima lettera ‘h’ che va, come richiesto, nella cella con chiave pari a 3. Questa op¬ 
erazione sovrascrive la lettera 'd' che già era stata inserita, in automatico, con chiave pari a 3. 
A questo punto dovrebbero essere chiari i motivi dell’assenza della lettera d’ e del particolare 
ordine con cui vengono visualizzati i valori contenuti nell’array. 

Un array può essere creato anche senza l’utilizzo del costrutto array ( ) ’, in questo caso la 
sintassi ricorda quella dei più comuni linguaggi di programmazione. 

Di seguito sono riportati gli esempi precedenti con l’utilizzo del secondo metodo di creazione. 

o <? 

1 $a[] = "a"; 

2 $a [ ] = "b"; 

3 $a[] = 44; 

4 $a[] = "d"; 

5 $a[] = "e"; 

6 print_r($a); 

7 ?> 


Il secondo esempio può essere tradotto in questo modo: 

o <? 

1 $a[] = "a"; 

2 $a[] = "b"; 

3 $a[] = "c"; 

4 $a[] = "d"; 

5 $ a[8] = "e"; 

6 $a[4] = "f"; 

7 $a [ ] = "g"; 

8 $a [3] = "h"; 

9 print_r($a); 

10 ?> 


I due procedimenti per la creazione degli array sono equivalenti. 


Gli array possono avere chiavi miste, come nell’esempio seguente, in cui alcune sono intere e 
alcune stringhe. 

o <? 

1 $a["rosso"] = "a"; 

2 $a[] = "c"; 

3 $ a[8] = "e"; 

4 $a["nero"] = "f"; 

5 $a[] = "g"; 

6 print_r($a); 

7 ?> 


Ecco il risultato: 

Array ( [rosso] => a [0] => c [8] => e [nero] => f [9] => g ) 

È interessante studiare una possibile applicazione pratica degli array. Nel seguente esempio verrà 
ripresa la funzione ‘date ( ) ’ già incontrata nella sezione [1711 

o <? 

1 // valorizzo 1'array dei giorni della settimana con il metodo classico. 

2 $giorno[0] = "Domenica"; 
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3 $giorno[l] = "Lunedì"; 

4 $gìorno[2] = "Martedì"; 

5 $gìorno[3] = "Mercoledì"; 

6 $gìorno[4] = "Giovedì"; 

7 $gìorno[5] = "Venerdì"; 

8 $gìorno[6] = "Sabato"; 


10 

Il valorizzo 1'array 

dei mesi dell'anno 

con il costrutto array() 

11 

$mese = array( 



12 

1 => 

"Gennaio", 


13 

2 => 

"Febbraio", 


14 

3 => 

"Marzo", 


15 

4 => 

"Aprile", 


16 

5 => 

"Maggio", 


17 

6 => 

"Giugno", 


18 

7 => 

"Luglio", 


19 

8 => 

"Agosto", 


20 

9 => 

"Settembre", 


21 

10 => 

"Ottobre", 


22 

11 => 

"Novembre", 


23 

12 => 

"Dicembre" 


24 

) ; 



25 

// Prendo il mese in 

formato numerico da 

1 a 12. 

26 

$numero_mese = date( 

"n") ; 


27 




28 

/* Prendo il giorno della settimana da 0 

(domenica) a 6 (sabato) 

29 

questa volta formatto tutto annidando 

più funzioni. 

30 

in PHP è possibile 

! */ 


31 

$gìorno_settimana 

= $giorno[date("w") 

] ; 

32 




33 

// Formatto la data nel modo: Lunedì 19 

Novembre 2001 

34 

$oggì = $gìorno_settimana." ",date("d") 

..$mese[$numero_mese]..date("Y' 

35 




36 

// Visualizzo la data 

a schermo concatendandola ad una stringa 

37 

echo "<br> Oggi è: <b>".$oggi."</b>"; 


38 

?> 



risultato di questo script, raggiungibile presso <http://www.urcanet.it/brdp/php_manual/ssempi/sap_2l 


data.php>, e: 

Oggi è: Domenica 18-Novembre-2001 


Gli array rappresentano una delle strutture più versatili in PHP, a differenza dei linguaggi classici, 
infatti, la dimensione non deve essere specificata a priori. Questo permette una dinamicità e una 
libertà di utilizzo notevole. 

Il PHP gestisce anche gli array multidimensionali e gli array annidati. 

Non si entrerà nel merito, si darà per scontata la teoria sulla gestione degli array, che è simile per 
i diversi tipi di linguaggi, mentre si tratterà la sintassi tramite uno script di esempio. 

Il seguente è un esempio sull’utilizzo degli array multidimensionali. 

0 <html> 

1 <head> 

2 <tìtle>Semplice Agenda telefonica statica</title> 

3 </head> 

4 <body> 

5 

6 <? 

7 /* 

8 Un semplice esempio di array multidimensionale. 

Una rubrica telefonica. 

*/ 


9 

10 
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11 

12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 
63 


$a["nome"][0] = "Gianluca"; 

$a["cognome"][0] = "Giusti"; 
$a["tei"][0] = "06/66666666"; 

$a["nome"][1] = "Mirko"; 

$a["cognome"][1] = "Simeoni"; 
$a [ "tei"] [1] = "07/77777777"; 

$a["nome"][2] = "Fabio"; 

$a["cognome"][2] = "Ferri"; 

$a["tei"][2] = "08/88888888"; 


r 


Adesso elenchiamo la rubrica 
utilizzare Nessuna struttura 
confondere le idee 


?> 

<br> 

<table border="l"> 

<tr bgcolor="gray" > 
<td>ID</td> 
<td>Nome</td> 
<td>Cognome</td> 
<td>Telefono</td> 
</tr> 

<tr> 

<td>0</td> 
<tdx?=$a [nome] [0 
<tdx?=$a [cognome 
<tdx?=$a [tei] [0] 
</tr> 

<tr> 

<td>l</td> 
<tdx?=$a [nome] [1 
<tdx?=$a [cognome 
<tdx?=$a [tei] [1] 
</tr> 

<tr> 

<td>2</td> 
<tdx?=$a [nome] [2 
<tdx?=$a [cognome 
<tdx?=$a [tei] [2] 
</tr> 


] ?x/td> 

] [0] ?x/td> 
?x/td> 


] ?x/td> 

] [1] ?x/td> 
?x/td> 


] ?x/td> 

] [ 2 ] ?x/td> 
?x/td> 


</table> 


</body> 
</html> 


Lo faremo senza 
ciclica per non 


Una volta salvato il codice nella propria directory dei documenti del servizio HTTP si può 
verificare il risultato. Anche questo esempio è disponibile all’indirizzo: <http:/.'www.urcanet.H'brdp/ 
php_manuaL'ìsempi l ;ap_2/agenda.php >,inoltre, il risultato è riportato in figura [2~TI 
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Figura[2j] La rubrica telefonica è stata formattata in una tabella HTML. 



Inutile dire che questo è solo un’esempio per prendere confidenza con la sintassi PHP relativa 
agli array e che esistono soluzioni migliori per il salvataggio dei dati. Più avanti nella guida si 
tratteranno i file e le basi di dati. 


Un esercizio molto utile lasciato al lettore è la realizzazione di uno script clone del precedente 
con l’utilizzo del costrutto ‘array ( ) ’ per la gestione dell’array utilizzato nella rubrica telefonica. 

Lo studio degli array di array viene momentaneamente lasciato al lettore come approfondimento, 
con l’impegno di tornare sull’argomento appena conclusi i punti fondamentali di questa guida. 

2.3.6 object 

Una classe è una collezione di variabili e di funzioni dette metodi. Una volta definita la classe è 
possibile istanziare uno o più oggetti della stessa classe. Ognuno di essi è indipendente dagli altri. 

Una trattazione approfondita può essere trovata nella sezione [6] di questa guida. 

2.4 Operatori 

Il PHP gestisce numerosi tipi di operatori, di seguito sono elencate le caratteristiche principali 
dei tipi utilizzati più di frequente. Per una trattazione completa si rimanda il lettore al manuale 
ufficiale. 

Tabella[Z3] Questi alcuni degli operatori gestiti dal PHP. 


OPERATORI 

aritmetici 

assegnazione 

controllo degli errori 

logici 

incemento e decremento 

confronto 


Verranno analizzati singolarmente gli operatori riportati nella tabella COI 

2.4.1 Operatori aritmetici 


Nella tabella |23 sono riportati gli operatori aritmetici con le rispettive caratteristiche. 
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Tabella[Z4] Le caratteristiche degli operatori aritmetici. 


Esempio 

Nome 

Risultato 

Sa + $b 

Addizione 

Somma tra Sa e Sb 

Sa - Sb 

Sottrazione 

Differenza tra Sa e $b 

Sa* Sb 

Moltiplicazione 

Prodotto tra $a e $b 

Sa/Sb 

Divisione 

Quoziente tra Sa e $b 


Lo schema è stato preso dal manuale ufficiale, è molto chiaro e non ha bisogno di molte spie¬ 
gazioni. Bisogna tenere ben presente che il tipo della variabile a cui si assegna il risultato dipende 
dal tipo dei due valori ’$a’ e ‘$b\ 

2.4.2 Operatori di assegnazione 

L’operatore fondamentale per l’assegnazione di un valore ad una variabile è ‘=’. La sintassi 
fondamentale è: 

o <? 

1 // assegno ad $a il valore intero 123 

2 $a = 123; 

3 

4 // assegno a $b il contenuto dì $a 

5 $b = $a; 

6 

7 // assegno una stringa alla variabile $c 

8 $c = "questa è una stringa"; 

9 ?> 


L’operatore ‘=’ può essere utilizzato insieme ad altri operatori elencati nell’esempio: 

o <? 

1 // assegno ad $a un valore intero 

2 $a = 2; 

3 

4 // assegno a $b un altro valore intero 

5 $b = 5; 

6 

7 // posso assegnare a $a la somma di $a e $b in questo modo 

8 $a = $a + $b; 

9 

10 // oppure in questo modo 

11 $a += $b; 

12 

13 // stesso discorso per tutti gli operatori aritmetici 

14 $a -= $b; 

15 $a *= $b; 

16 $a /= $b; 

17 

18 // posso anche assegnare un valore a più variabili 

19 $a = $b = 30; 

20 

21 // o ancora in questo esempio sia $a che $b valgono 6 

22 $a = 3; 

23 $b = $a += 3; 

24 

25 // per le stringhe. $a varrà "ciao a tutti!!!" 

26 $a = "ciao a"; 

27 $a .= " tutti ! ! !"; 

28 

29 // equivale a concatenare la stringa in questo modo 

30 $a = "ciao a"; 
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31 $a = $a." tutti ! ! ! " ; 

32 ?> 


I commenti inseriti nell’esempio dovrebbero bastare a descrivere la versatilità degli operatori 
appena trattati. 

2.4.3 Operatori di controllo degli errori 


Nell’esempio seguente viene gestito un errore dovuto al tentativo di lettura di un file inesistente. 
Con l’occasione viene utilizzata la funzione PHP ‘file ( ' nome_del_file' ) ’ che restituisce un 
array contenente le righe del file passato alla funzione. 

o <? 

1 // provo ad aprire un file che non esiste 

2 $fìle_array = file('file_inesìstente') or 

3 dìe (" Errore durante l'apertura del file. "); 

4 

5 /* 

6 il file non esiste, lo script si ferma 

7 mostrando i messaggi di errore 

8 */ 

9 ?> 


Se si salva il codice in un file e si richiama tramite il navigatore, si nota che oltre al messaggio 
di errore inserito nello script viene visualizzato un messaggio introdotto dall’interprete PHP. 1 
messaggi di errore possono contenere informazioni utili ai male intenzionati, è bene, quindi, 
gestire tali messaggi al meglio. Un esempio è riportato in figura 12.21 dove si nota il percorso su 
file System dello script di prova. 

Figura 12,21 Ecco come appare la pagina contenente l'errore non gestito. Oltre al 
messaggio di errore da noi inserito viene visualizzato anche un warning dall'interprete 
PHP. 



Un modo molto semplice per non far visualizzare i messaggi d’errore dell’interprete è 
premettere il carattere ‘@’ alla funzione. Ad esempio: ‘@file ( ' dati. txt ' ) ’. 


L’esempio precedente potrebbe essere modificato in questo modo: 

o <? 

1 // provo ad aprire un file che non esiste 

2 $fìle_array = @fìle('file_ìnesistente') or 

3 die (" Errore durante l'apertura del file. "); 

4 /* 

5 In questo caso il messaggio di errore dell'interprete 
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6 PHP è stato silenziato dalla premessa alla funzione file(). 

7 Verrà quindi mostrato solo il nostro messaggio di errore 

8 */ 

9 ?> 


Il costrutto 'die () ’ non fa altro che terminare l’esecuzione del programma, in caso di errore, 
mostrando il messaggio contenuto tra le parentesi. 

2.4.4 Operatori di incremento e decremento 


Come detto, la sintassi PHP ricorda molto quella del C. Gli operatori di pre e post incrementazione 
sono gestiti come nel linguaggio C. 

Nella tabella [231 sono riportati i quattro operatori: 

Tabella |Z5] Questi gli operatori di incremento e decremento gestiti dal PHP. 


Esempio 

Nome 

Risultato 

‘$a++’ 

Post-incremento 

Restituisce ‘$a‘ e poi la incrementa di uno 

‘++$a' 

Pre-incremento 

Incrementa di uno '$a‘ e poi la restituisce 

■$a—’ 

Post-decremento 

Restituisce ‘$a' e poi la decrementa di uno 

$a' 

Pre-decremento 

Decrementa di uno '$a' e poi la restituisce 


Nell’esempio seguente vengono utilizzati i quattro operatori: 

o <? 

1 $a = 1; 

2 

3 // Operatori di pre-ìncremento 

4 

5 echo "<br>La variabile vale: ".++$a; 

6 echo " e dopo vale: ".$a; 

7 

8 // Operatori di post-incremento 

9 

10 echo "<br>La variabile vale: ".$a++; 

11 echo " e dopo vale: ".$a; 

12 

13 // Operatori di pre-decremento 

14 

15 echo "<br>La variabile vale: $a; 

16 echo " e dopo vale: ".$a; 

17 

18 // Operatori di post-decremento 

19 

20 echo "<br> La variabile vale: ".$a—; 

21 echo " e dopo vale: ".$a; 

22 

23 ?> 


Se si prova a salvare l’esempio in un file nella directory del servizio HTTP, una volta richiamato 
mediante il navigatore, il risultato sarà di questo tipo: 

La variabile vale: 2 e dopo vale: 2 

La variabile vale: 2 e dopo vale: 3 

La variabile vale: 2 e dopo vale: 2 

La variabile vale: 2 e dopo vale: 1 


Ragionando passo passo si capisce il lavoro dell’interprete e di conseguenza il risultato ottenuto. 
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La variabile inizialmente vale 1. Nella riga 5 viene incrementata, prima di essere visualizzata, 
tramite l’operatore ‘++$a\ Nella riga 6 viene mostrato il valore di ‘$a’ senza eseguire alcuna 
operazione. Da queste prime due righe di codice si ottiene la riga: 

La variabile vale: 2 e dopo vale: 2 


Nella riga 10, invece, viene utilizzato l’operatore ‘$a++’ che prima visualizza il contenuto della 
variabile e poi lo incrementa. Infatti la riga 11 restituisce un valore di ‘$a’ pari a 3. Il risultato è 
evidente nella seconda riga del file HTML generato dallo script di prova. 

Stessa procedura per gli operatori di pre e post decremento, fino a ritornare al valore iniziale della 
variabile. 


2.4.5 Operatori logici 

Gli operatori logici gestiti dal PHP sono riportati nella tabella IZril 
Tabella|Z6] Questi gli operatori logici gestiti dal PHP. 


Esempio 

Nome 

Risultato 

‘$a and $b’ 

AND 

vera se $a e $b sono vere 

‘$a or $b' 

OR 

vera se $a o $b è vera 

‘$a Xor $b' 

XOR 

vera se $a o $b è vera ma non entrambe 

‘!$a' 

NOT 

Negazione. Vera se $a non è vera 

'$a && $b' 

AND 

Simile a and' ma con precedenza diversa 

‘$a | | $b' 

OR 

Simile a ‘or’ ma con precedenza diversa 


Le precedenze degli operatori sono riportate nel manuale ufficiale. 

In questo momento è inutile dilungarsi in esempi, gli operatori logici verranno approfonditi in 
seguito. In particolare verranno trattati con l’introduzione dell’istruzione ‘if’. 

2.4.6 Operatori di confronto 

Il PHP gestisce tutti gli operatori di confronto riportati nella tabella IZ7l 


Tabella|27] Gli operatori di confronto gestiti dal PHP. 


Esempio 

Nome 

Risultato 

‘$a == $b' 

Uguale 

vera se Sa è uguale a $b 

■$a === $b' 

Identico 

vera se Sa è uguale a $b e sono dello stesso tipo 

‘$a ! = $b' 

Diverso 

vera se $a è diverso da $b 

‘$a <> $b' 

Diverso 

vera se Sa è diverso da $b 

■$a !== $b" 

Non Identico 

vera se Sa non è uguale a $b o non sono dello stesso tipo 

‘$a < $b' 

Minore 

vera se Sa è minore di $b 

‘$a > $b' 

Maggiore 

vera se $a è maggiore di $b 

’$a <= $b' 

Minore o uguale 

vera se Sa è minore o uguale a Sb 

‘$a >= $b' 

Maggiore o uguale 

vera se $a è maggiore o uguale a $b 


Esempi pratici sugli operatori di confronto verranno trattati in seguito, nella guida, con 
l’introduzione delle «strutture di controllo». 
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Nella tabella 12.81 sono riportate le strutture di controllo che verranno trattate in dettaglio nelle 
pagine seguenti. 

Tabella|Z8] Le strutture di controllo, 


Strutture 

di controllo 


if 

while 

break 

else 

do..while 

include!) 

elseif 

for 


switch 

foreach 



le strutture di controllo sono state raggruppate per tipologia e ordinate secondo la difficoltà. Di 
seguito verranno trattati prima i costrutti più semplici e poi quelli più complessi. 

Nella prima colonna sono raccolte le strutture tramite le quali si è in grado di eseguire determinate 
istruzioni al verificarsi di particolari condizioni. 

Nella seconda colonna sono raccolte le strutture mediante cui è possibile realizzare e gestire delle 
operazioni cicliche, fino a quando una particolare condizione viene soddisfatta e interrompe il 
ciclo. 

In questo ultimo caso è importante tenere sempre presente la condizione di STOP. Questo per 
evitare dei cicli infiniti che possono bloccare il funzionamento del programma. 

Inoltre negli esempi che seguono verranno utilizzati gli operatori precedentemente introdotti. 

2.5.1 if 

Il costrutto ‘if ’ è molto importante e utilizzato in tutti i linguaggi di programmazione. La sintassi 
è la seguente: 


if (condizione) 

singola istruzione 


Utilizzato in questo modo, solamente un’istruzione è condizionata dall’esito della condizione 
contenuta nel costrutto ‘if’. Ecco un esempio: 

o <? 

1 $a = 3; 

2 $b = 5; 

3 

4 if($a < $b) // uso un operatore di confronto 

5 echo "Condizionato da if. Solo se \$a è minore di \$b."; 

6 

7 echo "<br>Questo, invece, viene scritto comunque!!!"; 

8 

9 ?> 


Se si ha bisogno di condizionare una o più istruzioni la sintassi da utilizzare è la seguente: 

if(condizione){ 
istruzione 1 
istruzione 2 
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istruzione n 

} 


Riprendendo l’esempio precedente si può scrivere: 

o <? 

1 $a = 3; 

2 $b = 5; 

3 

4 if($a < $b){ 

5 echo "Istruzione 1."; 

6 echo "Istruzione 2."; 

7 echo "Istruzione 3."; 

8 } 

9 

10 echo "<br>Questo, invece, viene scritto comunque!!!"; 

11 

12 ?> 


La differenza è semplice e lampante. Il blocco delle istruzioni condizionate va contenuto tra le 
parentesi‘{ }’. 

2.5.2 else 

Nell’ultimo esempio viene gestito un solo evento. Se si volesse gestire anche l’evento $a >= 
$b si potrebbe aggiungere, in modo poco elegante e funzionale, un altra ‘if ($a >= $b) { 
istruzioni } ’. Tuttavia la soluzione più corretta è sicuramente l’utilizzo della struttura ‘else’ 

La sintassi del costrutto ‘else’ è la seguente: 

if(condizione){ 

istruzione 1 
istruzione 2 


istruzione n 
}else{ 

istruzione 1 
istruzione 2 


istruzione m 


} 


Di seguito sono riportati alcuni esempi per chiarirne l’utilizzo e per prendere confidenza con gli 
operatori precedentemente trattati. 

o <? 

ì 

2 if(!$a){ // $a è falso. 

3 $a = "ok"; 

4 }else{ 

5 $a = 


ko " ; 
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6 } 

7 

8 //a questo punto $a vale "ok" 

9 

10 if($a == "ok"){ 

11 echo "Sono entrato nell'if e \$a vale: ".$a; 

12 echo "<br> Adesso cambiamo il contenuto di \$a"; 

13 $a = 17; 

14 }else{ 

15 echo "\$a non vale \"ok\" e quindi mi trovo nell'else. \$a: ".$a; 

16 echo "<br> anche in questo caso setto \$a uguale a 17 ma in modo diverso. 

17 $a = 16; 

18 $a += 1; 

19 } 

20 

21 // adesso scrivo il tipo e il valore di $a 

22 

23 if(is_integer($a)){ 

24 echo "<br> \$a è un INTERO e vale: ".$a; 

25 }else{ 

26 echo "<br> \$a NON è un intero e vale: ".$a; 

27 } 

28 

29 ?> 


Lo script, così come nell’esempio, restituisce un risultato simile al seguente: 

Sono entrato nell'if e $a vale: ok 
Adesso cambiamo il contenuto di $a 
$a è un INTERO e vale: 17 


Per comprendere al meglio il flusso del programma e delle strutture in esso contenute, si può 
inserire nella riga 1 la valorizzazione di "$a\ ad esempio: 

1 $a = "qualche valore"; 

Così facendo l’esito del primo ‘if ’ cambia e di conseguenza tutto il resto dello script. 

Con l’occasione si è utilizzata una nuova funzione, ‘is_integer () ’, che restituisce un valore 
booleano vero se la variabile ad essa fornita è di tipo intero, falso se la variabile non è intera. 

Esistono altre funzioni simili per verificare il tipo delle variabili, tra cui: ‘is_array () 
‘is_double () ’, ‘is_string () ’. Il funzionamento è analogo a quello di ‘is_integer () ’. 
Ovviamente esistono altre funzioni di questo tipo e sono raccolte nella sezione «Funzioni di 
Variabili» del manuale ufficiale del PHP. 

2.5.3 elseif 

Si supponga di dover gestire il confronto tra due variabili "$a’ e ‘$b’ di tipo intero. I possibili 
risultati del confronto sono tre: 

• $a > $b 

• $a < $b 

• $a = $b 

Utilizzando le strutture viste fino ad ora, non si è in grado di risolvere il problema. Una soluzione 
poco elegante, e sicuramente non ottimale, è eseguire tre ‘if’ in cascata. 
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Per risolvere problemi di questo tipo il PHP mette a disposizione la struttura ‘elseif ’. La sintassi 
è analoga a quella di "else’. 

if(condizione){ 

istruzione 1 
istruzione 2 


istruzione n 

jelseif(condizione){ 

istruzione 1 
istruzione 2 


istruzione m 
}else{ 

istruzione 1 
istruzione 2 


istruzione k 


} 

Ecco come applicare la sintassi all’esempio precedentemente descritto: 

o <? 

1 $a = 3; // valorizzo la variabile $a a mio piacere 

2 $b = 6; // valorizzo la variabile $b a mio piacere 

3 

4 // adesso eseguo il confronto con un unica istruzione elseif 

5 

6 if ($a > $b) { 

7 echo " \$a è maggiore di \$b 

8 } elseif ($a == $b) { 

9 echo " \$a è uguale a \$b 

10 } else { 

11 echo " \$a è minore di \$b 

12 } 

13 

14 ?> 


Dunque in questo modo si è in grado di gestire più condizioni. Il flusso è molto semplice e intuiti¬ 
vo. Se una delle due condizioni è soddisfatta l’interprete esegue le istruzioni ad essa associate ed 
esce dal blocco ‘elseif’. Se è presente un ‘else’ finale e nessuna condizione è stata soddisfatta, 
l’interprete ne esegue le istruzioni e lascia il blocco ‘elseif’. 


Va precisato che viene eseguito al massimo un blocco di istruzioni. Se più condizioni sono 
soddisfatte, solo le istruzioni associate alla prima condizione vera vengono eseguite, le altre 
vengono saltate. 
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Si può inserire più di un ‘elseif (condizione) ’ all’interno della struttura. Vediamo come, 
modificando l’esempio precedente. 

o <? 

1 $a = 3; // valorizzo la variabile $a a mio piacere 

2 $b = 6; // valorizzo la variabile $b a mio piacere 

3 

4 // adesso eseguo il confronto con un unica istruziione elseif 

5 


6 

if ($a > 

$b) { 

7 

echo " 

\$a è maggiore di \$b 

8 

} elseif 

<$a === $b) { 

9 

echo " 

\$a è identica a \$b"; 

10 

} elseif 

($a == $b) { 

il 

echo " 

\$a è uguale a \$b 

12 

} else { 


13 

echo " 

\$a è minore di \$b " 

14 

} 


15 



16 

?> 



Per verificare la correttezza e capire il diverso funzionamento, si provi ad assegnare alla variabile 
‘$b’ i seguenti valori: 

• $b = 6; 

• $b = 3; 

• $b = 3.0; 

Infine si modifichino le righe interessate allo script di esempio nel seguente modo: 

8 } elseif ($a == $b) { 

9 echo "\$a è uguale a \$b"; 

10 } elseif ($a === $b) { 

11 echo " \$a è identica a \$b 

In questo modo la voce ‘$a è identica a $b’ non viene mai visualizzata. Al lettore il 
semplice compito di scoprirne il motivo. ® 

2.5.4 switch 

Spesso ci si trova a dover confrontare il contenuto di una variabile con più valori, in questi casi è 
preferibile utilizzare la struttura ‘switch’ al posto di ‘elseif’. Un esempio renderà più chiaro 
il concetto. 

Si supponga di dover gestire un menu. In base al valore di una variabile vengono eseguite una 
o più operazioni. Nell’esempio la variabile ‘$scelta’ è valorizzata nella riga 2. Per provare il 
funzionamento del programma basterà cambiare il valore a questa variabile. 

o <? 

1 // valorizzo la variabile $scelta 

2 $scelta = 0; 

3 

4 // con switch gestisco i confronti e le operazioni. 

5 


5 La condizione di identità include quella di uguaglianza, quindi, se due variabili sono identiche di conseguenza sono 
anche uguali, mentre non è vero il contrario. Ecco perchè bisogna fare attenzione all’ordine in cui si scrivono le condizioni. 
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6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 


switch ($scelta) { 
case 0 : 

echo "<br> lancio l'istruzione associata al valore 0 " 
break; // esce da switch 
case 1 : 

echo "<br> lancio l'istruzione associata al valore 1 " 
break; // esce da switch 
case 2 : 

echo "<br> lancio l'istruzione associata al valore 2 " 
break; // esce da switch 
default : 

echo "<br> NESSUNA OPERAZIONE ASSOCIATA alla scelta"; 


} 

?> 


Nella struttura ‘switch’ a differenza di ‘elseif’, l’interprete esegue le istruzioni successive al 
‘case’ soddisfatto. Questo è il motivo per cui si utilizza il comando ‘break’. Più avanti si tratterà 
questo costrutto, per il momento basta sapere che serve ad abbandonare la struttura di controllo. 

L’esempio precedente genera un risultato di questo tipo: 

lancio l'istruzione associata al valore 0 


Se non ci fossero i ‘break’ in ogni blocco di istruzione il risultato sarebbe: 

lancio l'istruzione associata al valore 0 
lancio l'istruzione associata al valore 1 
lancio l'istruzione associata al valore 2 
NESSUNA OPERAZIONE ASSOCIATA alla scelta 


Se il funzionamento di ‘switch’ non risulta ancora chiaro, si provi, dopo aver tolto le istruzioni 
‘break’, ad assegnare alla variabile ‘$scelta’ i valori: 0,1 e 2, verificandone i singoli risultati. 

Nel caso di più uguaglianze la differenza tra ‘switch’ e ‘elseif’ è minima, in questi casi, 
l'utilizzo di ‘switch’ risulta più elegante e leggibile di ‘elseif’. Di seguito viene riportato 
l’esempio precedente riscritto utilizzando la struttura elseif. 

o <? 

1 // valorizzo la variabile $scelta 

2 $scelta = 0; 

3 

4 // adesso utilizzo elseif per gestire le operazioni 

5 

6 if($scelta == 0) { 

7 echo "<br> lancio l'istruzione associata al valore 0 "; 

8 jelseif($scelta == 1){ 

9 echo "<br> lancio l'istruzione associata al valore 1 "; 

10 jelseif($scelta == 2){ 

11 echo "<br> lancio l'istruzione associata al valore 2 "; 

12 }else{ 

13 echo "<br> NESSUNA OPERAZIONE ASSOCIATA alla scelta"; 

14 } 

15 

16 ?> 
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Il ‘while’ è la struttura di gestione dei cicli più semplice del PHP. La traduzione in italiano è: 
"mentre". 

La sintassi è la seguente: 

while(condizione){ 
istruzione 1 
istruzione 2 


istruzione n 

} 


Cioè: «mentre la condizione è vera esegui le istruzioni». 

Il seguente esempio può aiutare a chiarire le idee. 

o <? 

1 $i=l; 

2 while ($i <= 6){ // mentre $i è minore o uguale a 7 

3 eoho "<br> \$i adesso vale: ".$i; 

4 $i++; 

5 } 

6 ?> 


Dunque, in questo caso la condizione di stop, che fa fermare il ciclo, è ‘$i > 6’. Ovvero ‘$i <= 
6’ è falsa. 

Il risultato è il seguente: 

$i adesso vale: 1 
$ì adesso vale: 2 
$ì adesso vale: 3 
$i adesso vale: 4 
$i adesso vale: 5 
$ì adesso vale: 6 


Tramite un semplice ciclo PHP si può generare una pagina HTML come quella riportata in figura 

IO 

Figura |Z3] Questo è stato generato dal ciclo 'while'. 
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Semplicemente è stato eseguito il seguente codice: 

0 <html> 

1 <head> 

2 <title>Ciclo while</title> 

3 </head> 

4 <body> 

5 

6 <br> Un ciclo WHILE<brxhr> 

7 

8 <? 

9 $i=l; 

10 while ($i <= 6){ 

11 ?> 

12 

13 <br> <font size="<?=$i?>">Questo è un font con size = <?=$i?X/font> 

14 

15 <? 

16 $ i++; 

17 } 

18 ?> 

19 

20 

21 </body> 

22 </html> 


Dal menu visualizza del navigatore, l’opzione sorgente pagina , mostra il seguente codice: 

0 <html> 

1 <head> 

2 <title>Ciclo while</title> 

3 </head> 

4 <body> 

5 <br> Un ciclo WHILE<brxhr> 

6 


7 

<br> 

<f ont 

size= 

"i 

">Questo 

è 

un 

font 

con 

size = l</font> 

8 

<br> 

<f ont 

size= 

"2 

">Questo 

è 

un 

font 

con 

size = 2</font> 

9 

<br> 

<f ont 

size= 

"3 

">Questo 

è 

un 

font 

con 

size = 3</font> 

10 

<br> 

<f ont 

size= 

"4 

">Questo 

è 

un 

font 

con 

size = 4</font> 

11 

<br> 

<f ont 

size= 

"5 

">Questo 

è 

un 

font 

con 

size = 5</font> 

12 

<br> 

<f ont 

size= 

"6 

">Questo 

è 

un 

font 

con 

size = 6</font> 


13 

14 </body> 

15 </html> 


Le righe dalla 7 alla 12 sono state generate dall’interprete con l’esecuzione del ciclo ‘while’ 
dell’esempio. 

2.5.6 do..while 

A differenza del ‘while’ il ‘do. .while’ esegue il controllo sulla condizione dopo l’esecuzione 
delle istruzioni. Ecco la sintassi: 

do { 

istruzione 1 
istruzione 2 


istruzione n 
}while(condizione) ; 
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Dunque l’interprete esegue le istruzioni e solo dopo controlla la condizione di stop, se è vera 
riesegue le istruzioni, se è falsa abbandona il ciclo. 

Di seguito è riportato un esempio costituito da due cicli, uno utilizza il costrutto ‘do. .while’, 
l’altro il ‘while’. Le condizioni iniziali e di uscita sono le stesse ma il risultato è diverso. Al 
lettore il compito di capire tali differenze. 

o <? 

1 // Condizione iniziale! 

2 $inizio=0; 

3 

4 // ciclo do..while 

5 

6 do{ 

7 echo "<br> ciclo: do..while. \$inizio vale: ",$inizio; 

8 jwhile($inizio > 0); 

9 

10 // mentre il ciclo while 

11 

12 while($inizio > 0){ 

13 echo "<br> ciclo: while. \$inizio vale: ",$inizio; 

14 } 

15 ?> 


2.5.7 for 

La sintassi del ciclo ‘for’ può sembrare incomprensibile ad una prima lettura, invece è molto 
coincisa, versatile e, con un po’ di pratica, semplice. Eccola: 


for(condizione iniziale; condizione stop; variazione parametro)! 
istruzione 1 
istruzione 2 


istruzione n 

} 


Tale sintassi viene applicata nel seguente modo: 

for($i=0; $i<10; $i++){ 

echo "<br>tutte le istruzioni che desidero"; 

} 


Il codice dell’esempio può essere letto come: «partendo da $i = 0, mentre $i< 10 esegui le 
istruzioni e incrementa $i di uno ». 

Sia le condizioni che la variazione possono essere omesse o incluse tra le istruzioni. Per il momen¬ 
to verrà trattata la sintassi classica. Il modo più semplice e diretto è, come al solito, un esempio 
ben commentato. 

o <? 

1 // sintassi classica: 

2 

3 for($1=0; $i<10; $i++){ 

4 echo "<br> non serve incrementare, lo fa il for"; 

5 echo "<br> infatti ecco il valore di \$i: ",$i; 

6 


} 
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7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 ?> 

Come detto è possibile omettere anche le condizioni iniziale e di stop. Per fare questo è neces¬ 
sario utilizzale la struttura ‘break’ che verrà introdotta nelle pagine seguenti. In quell’occasione 
verranno trattate tali eccezioni. 

A questo punto, un ottimo esercizio per il lettore è la traduzione degli esempi visti per le strutture 
del 'while’ e ‘do. . while’, in script uguali o simili utilizzando le varie derivazioni del costrutto 

‘for’. 

2.5.8 foreach 

Va subito notato che il costrutto ‘foreach’ è stato implementato dalla versione 4.0 in poi e quindi 
non è gestita dalle versioni precedenti del PHP. 

L’uso del ‘foreach’ è indicato per la gestione degli array e mette a disposizione due sintassi 
principali: 

foreach($variabile_array as $value){ 
istruzioni 

} 
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// se ho una sola istruzione, come con l'if 
for ($i=0; $i<10; $i++) 

echo "<br> per una sola va bene così. \$i vale: ".$i; 

// oppure se è solo un print 
for($i=0; $i<10; print"<br>".$i, $i++) 

// Ancora posso incrementare $i tra le istruzioni 
for($i=0; $i<10 ; ){ 

echo "<br>incrementare \$i altrimenti il ciclo è infinito. \$i=".$i; 
$ i++; 

} 

// Oppure premetto la condizione iniziale. 

$i=0; 

for( ; $i<10 ; $i + + ){ 

echo "<br>eccolo : ",$i; 

} 


e: 


foreach($variabile_array as $key => $value){ 
istruzioni 


} 


il suo funzionamento, a differenza del semplice ‘for’, non è molto intuitivo ed è vincolato al- 
l’utilizzo di un array. Si nota immediatamente che la sintassi non richiede l’utilizzo di indici ne 
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di incrementi, infatti il costrutto opererà su tutti gli argomenti dell’array indistintamente. Dunque 
questo strumento risulta comodo e versatile quando si ha a che fare con array con chiavi particolari 
o non consecutive (nel caso di chiavi numeriche). 

Si supponga di avere un primo array composto da chiavi intere e consecutive simile al seguente: 

<? 

$array_l = array (1, "a", 5, "c", "ciao"); // con chiavi da 0 a 4 
print_r($array_l) ; 

?> 


e un secondo composto da chiavi miste e quindi non consecutive come questo: 


<? 

$array_2 = array ( 

"uno" => 1, 

"frutta" => "mela", 
5 => "cinque", 

40 => 30 

) ; 

print_r($array_2) ; 

?> 


// chiave stringa e valore intero 
// chiave stringa e valore stringa 
// chiave intero e valore stringa 
// chiave intero e valore intero 


I risultati dei due script sono semplicemente: 

Array ( [0] => 1 [1] => a [2] => 5 [3] => c [4] => ciao ) 

Array ( [uno] => 1 [frutta] => mela [5] => cinque [40] => 30 ) 


Si supponga ora di non conoscere le chiavi del secondo array perchè assegnate dinamicamente da 
un codice precedente. In questo caso non si sarebbe in grado di operare su IL array con le strutture 
cicliche classiche perchè non c’è nessuna relazione tra le chiavi. Mentre nel primo la relazione 
tra le chiavi è semplice, sono interi successivi a partile da 0. In queste situazioni la struttura 
■foreach’ è tanto indispensabile quanto semplice ed immediata da utilizzare. 

L’esempio potrebbe continuare con la necessità di separare i valori interi da quelli non interi, con¬ 
tenuti in ‘$array_2’. Di seguito viene risolto il problema con l’utilizzo del costrutto ‘foreach’ 
e della prima sintassi. 

o <? 

1 foreach ($array_2 as $val) { 

2 echo "<br>\$val = ".$val; 

3 if(is_integer($val)) { 

4 echo " -&gt; ed è un intero..."; 

5 // possono seguire istruzioni per trattare i dati interi 

6 }else{ 

7 echo " -&gt; ma non è un intero..."; 

8 // possono seguire istruzioni per trattare i dati NON interi 

9 } 

10 } 

11 ?> 

■foreach’ in italiano può essere tradotto come ‘per ogni’, dunque la sintassi è ora più chiara: 
per ogni valore dell’array ‘$array_2’ preso come ‘$val’ esegui le istruzioni associate. 

Il costrutto ad ogni ciclo valorizza la variabile ‘$val’ con un elemento dell’array. Ripete 
l’operazione per tutti gli elementi indipendentemente dalle chiavi ad essi associati. 

Nell’esempio le cose sono state complicate con l’annidamento di un ‘if’ che verifica ad ogni 
ciclo il tipo di dato estratto dall’array, il risultato è il seguente: 
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$val = 1-> ed è un intero. . . 

$val = mela -> ma non è un intero... 

$val = cinque-> ma non è un intero. . . 

$val = 30 -> ed è un intero... 


A questo punto è semplice dedurre il funzionamento della seconda sintassi, infatti, il ‘foreach’ 
può estrarre sia la chiave che il valore degli elementi contenuti nell’array. Complicando 
ulteriormente lo script precedente si può verificare il funzionamento della seconda sintassi. 


o 

ì 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 
13 


<? 

foreach ($array_2 as $chiave => $valore) { 
echo "<br>\$val = ".$valore; 
ìf(ìs_ìnteger($valore)){ 

echo " -&gt; ed è un intero..."; 

echo " -&gt; questa la sua chiave: ".Schiave; 

// possono seguire istruzioni per trattare i dati interi 
}else{ 

echo " -&gt; ma non è un intero..."; 

echo " -&gt; questa la sua chiave: ".Schiave; 

// possono seguire istruzioni per trattare i dati NON interi 

} 

} 

?> 


Sono state aggiunte le righe 5 e 9 che visualizzano il volore delle chiavi ed è stata modificata 
la sintassi della riga 1 in cui si chiede al ‘foreach’ di estrarre anche le chiavi degli elementi 
dell’array oltre al valore e di assegnarli alle variabili ‘$chiave’ e Evalore’. Il risultato è il 
seguente: 

$val = 1 -> ed è un intero... -> questa la sua chiave: uno 

$val = mela -> ma non è un intero... -> questa la sua chiave: frutta 

$val = cinque -> ma non è un intero... -> questa la sua chiave: 5 

$val = 30 -> ed è un intero... -> questa la sua chiave: 40 


In conclusione il costrutto "foreach’ è una struttura ciclica dedicata alla manipolazione degli 
array. Ovviamente possono essere gestiti anche array multidimensionale con dei ‘foreach’ 
annidati, il lettore può approfondire l’argomento sul manuale ufficiale. 

L’esempio trattato è raggiungibile all’indirizzo: <http:, , .'www.urcanet.it'brdp/php_manuaVssempi, , "ap_2/ 
foreach.php> 

2.5.9 break 

Il costrutto ‘break’ serve ad abbandonare una struttura di controllo, nel dettaglio permette di us¬ 
cire da: ‘for’, ‘foreach’, ‘while’, ‘do. .while’ e ‘switch’, e ammette un parametro numerico 
opzionale. Tale parametro deve essere un intero che indicherà il "livello" della struttura da abban¬ 
donare. Ad esempio, nel caso di due o più strutture annidate, si potrebbe voler uscire da una o più 
di esse: questo è possibile tramite il parametro. 

Con l’occasione verranno approfondite, negli esempi seguenti, le strutture tralasciate in 
precedenza. 

o <? 

ì 

2 $ 1 = 0 ; 

3 while (++$i) { // il while incrementa anche in questo modo 
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if($i == 3){ 

echo "<br>Conto fino a ed esco solo dal conteggio: 


10 

if ($t > $i) { 



11 

break 1; // esce solo dal for equivale a break senza parametri 

12 

} 



13 

echo " ",$t; 



14 

} 



15 




16 

jelseif($i == 9){ 



17 




18 

echo "<br> Conto fino a ",$i." ed 

esco dal for e 

dal while:"; 

19 




20 

\ —1 

II 

-M 

•co- 



21 

for (;;) { // Nessuna condizione 

è espressa nel 

costrutto. 

22 

if ($t > $i) { 



23 

break 2; //il parametro è 2 

quindi esce dal 

for e dal while. 

24 

} 



25 

echo " ",$t; 



26 

$t++; 



27 

} 



28 




29 

} 



30 




31 

} 



32 




33 

echo "<br><br> fine dello script!"; 



34 




35 

?> 




Come detto in precedenza, è importante curare l’indentazione del codice. L’ultimo esempio è 
composto da un ciclo ‘while’ che include un elseif’ e due cicli ‘for’ che, a loro volta, con¬ 
tengono un ‘if ’ ciascuno. Tutto questo susseguirsi di parentesi può creare confusione e rendere 
il codice illegibile se non si presta attenzione all’indentazione. 

Nella maggior parte dei casi, se il codice è ben scritto e ragionato, non si ha bisogno della struttura 
‘break’. Tuttavia è bene sapere che esiste. 

2.5.10 includeO 

Il PHP permette di includere uno o più file in un punto ben preciso di un altro file. Tali file 
possono, a loro volta, contenere codice PHP che verrà interpretato se delimitato dagli appositi 
marcatori. 

Si pensi alla gestione di modelli grafici, alla necessità di dichiarare le stesse variabili in più file, 
alTinclusione di funzioni già pronte e via dicendo. In tutti questi casi è possibile creare un file 
specifico in cui inserire il codice che va incluso negli script. Ovviamente è possibile includere 
anche file residenti su macchine diverse dalla nostra. Di seguito vedremo come fare. 

Per l’inclusione dei file il PHP offre diverse soluzioni. In questa guida verrà approfondita la 
funzione ‘include () ’. Ne esistono altre che sono riportate nel manuale ufficiale. 

La sintassi di base è la seguente: 

o <? 

1 // inclusione di un file chiamato esterno.html 

2 
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3 include('esterno.html ') ; 

4 

5 ?> 


è preferibile utilizzale le stringhe con doublé quote perchè meglio gestite e più versatili: 

o <? 

1 // oppure con il doublé quote 

2 

3 includeCesterno.html"); 

4 

5 ?> 


Come accennato in precedenza, il file da includere può trovarsi su una macchina diversa dalla 
nostra. Supponiamo che sia accessibile tramite il protocollo HTTP. La sintassi sarà: 

o <? 

ì 
2 

3 

4 

5 

6 include("http://www.url_altro_sito.com/esterno.html"); 

7 

8 ?> 


/* inclusione di un file remoto. 

Su una macchina diversa, tramite 
il protocollo HTTP 

*/ 


Questo modo di operare è del tutto corretto. Tuttavia va tenuto conto dei seguenti fattori: 

• l’elevato tempo di accesso al servente remoto, che può causare un ritardo nella generazione 
della pagina e può rallentare notevolmente la visualizzazione della stessa; 

• l’elaboratore servente potrebbe essere irraggiungibile o il file essere inesistente; 

• il contenuto del file remoto potrebbe essere modificato a nostra insaputa. 


Alcuni di questi ostacoli possono essere aggirati, altri no. Ad esempio, il primo problema non 
è risolvibile. Per quanto una connessione sia veloce ed i servizi performanti si aggiunge sempre 
un intervallo di tempo dovuto alla procedura di richiesta del file. Questo è un parametro molto 
importante, che va tenuto presente quando si effettua una scelta di questo tipo. Il tempo necessario, 
inoltre, non è sempre lo stesso ma dipende da svariati fattori, ad esempio il traffico sul sito remoto, 
il traffico sulla rete, ecc... 

Il secondo punto può essere affrontato in vali modi, quello più sbrigativo è sicuramente la gestione 
dell’errore generato con la mancata inclusione del file. Ecco un modo di procedere: 

o <? 

ì 

2 

3 

4 

5 

6 if( !@include("http://www.url_altro_sìto.com/esterno.html") ) 

7 echo "<brxbr> Problemi di visualizzazione! torna a trovarci..."; 

8 

9 ?> 


/* inclusione di un file remoto. Su una macchina diversa, 
tramite il protocollo HTTP. 

Compresa la gestione dell'errore!!! 

*/ 


In questo modo si è reso invisibile l’eventuale messaggio di errore dell’interprete tramite il pre¬ 
fisso "@\ Per il resto si tratta di un semplice ‘if’ che verifica il valore restituito dalla funzione 
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‘include ()’, se il valore è falso visualizza il messaggio di errore, altrimenti include il file e 
prosegue. 


Se il file remoto è uno script, ad esempio PHP, prima di essere incluso viene interpretato dal 
servente, quindi viene incluso il risultato dello script generato in remoto e non sull’elaboratore 
su cui è ospitato il nostro script . 


Programmare in PHP — Copyright © 2001-2003 Gianluca Giusti — brdp @ urcanet.it 






Capitolo 


Passaggio di variabili tramite l'HTTP 

Fino ad ora sono stati trattati i casi di singole pagine PHP in cui le variabili sono valorizzate, 
manipolate e visualizzate con l’interpretazione del singolo file. In questo modo l’utente che naviga 
la pagina non è in grado di interagire con gli script, non può passare dei dati al programma perchè 
non può editarne il codice. Il protocollo HTTP permette, tramite i marcatori HTML di passare dei 
dati tra le pagine, il PHP è in grado di ricevere ed elaborare queste informazioni. 

Nelle pagine seguenti verranno trattati i metodi di scambio di variabili dando per scontata la 
conoscenza, come detto in principio, dell’HTML. 

L’HTML permette al navigatore di inserire dati tramite il marcatore ‘forni che riceve dagli at¬ 
tributi ‘action’ e ‘method’ le direttive relative al file che deve ricevere i dati e al modo in cui 
essi devono esseregli passati. L’attributo ‘method’ ammette due possibili valori: ‘get’ e ‘post’. 
Di seguito saranno approfondite le differenze tra i due metodi. 

3.1 Metodo get 

Quando si sceglie il metodo ‘get’ le variabili ed il relativo valore vengono fornite allo script 
destinatario tramite la barra dell’indirizzo del browser. 

Il modo migliore per chiarire il concetto è l’utilizzo di un esempio. Verranno realizzati due script, 
‘get_l. html’ e ‘get_2 . php’. ‘get_l. html’ invierà i dati contenuti nel ‘form’ a ‘get_2 . php’ 
utilizzando il metodo ‘get’, ‘get_2 .php’ riceverà i dati, li manipolerà e li visualizzerà in una 
semplice pagina di saluto. Questo l’indirizzo dell’esempio: <http://www.urcanet.it'brdp/php_manual/ 
esempi/ ;ap_3/get_l. html > 

Ecco il codice del file ‘get_l. html’: 

0 <html> 

1 <head> 

2 <title> Passaggio del nome! </title> 

3 </head> 

4 

5 <body> 

6 

7 <br> 

8 Una semplice pagina HTML che passa nome e cognome ad 

9 uno script PHP che saluterà il navigatore. 

10 <brxbr> 

11 

12 <form method="get" actìon="get_2,php"> 

13 

14 Dimmi il tuo nome: <input type="Text" name="nome"> <brxbr> 

15 Ed ora il Cognome: <input type="Text" name="cognome"> <brxbr> 

16 

17 <input type="Submìt" value="Adesso invia i dati in GET &gt;&gt;"> 

18 

19 </form> 

20 

21 </body> 

22 </html> 


Il primo file invia i due campi di testo al file destinatario ‘get_2 .php’ che riceve due variabili 
valorizzate con i dati inseriti dal navigatore. Le variabili hanno il nome del campo del ‘form’, 
nell’esempio le variabili sono ‘$nome’ e ‘$cognome’ e sono di tipo stringa. 

Il codice del secondo script è molto semplice, non fa altro che visualizzare i valori delle due 
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0 <html> 

1 <head> 

2 <title> Pagina di destinazione... </title> 

3 </head> 

4 

5 <body> 

6 

7 Ciao, <brxbr> 

8 

9 II tuo nome è: <?=$nome?> <br> 

10 e il tuo cognome è: <?=$cognome?> 

11 

12 </body> 

13 </html> 

Figura|3j] Come appare il 'forni di invio dei dati, 



Figura [32] Nella barra degli indirizzi è evidenziata la sintassi del metodo 'get' per il 
passaggio delle variabili. 



L’obiettivo di questo esempio è quello di capire come funziona il metodo ‘get’, per farlo basta 
leggere il contenuto della barra degli indirizzi nel browser durante la visualizzazione dello script 
destinatario. L’indirizzo è simile a: 

http://www.urcanet.it/ ... ual/esempi/cap_3/get_2.php?nome=Gianluca&cognome=Giust 


Risulta semplice e intuitivo capire come vengono passate variabili e valori. All’indirizzo della 
pagina viene aggiunto un carattere “?’ e di seguito tutte le coppie di variabili e rispettivo valore 
separate dal “=’, ad esempio: ‘nome=Gianluca’. Le coppie sono poi separate dal carattere 
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3.2 Metodo post 

Nel metodo ‘post’ i dati non vengono visualizzati in nessun modo, essi sono spediti tramite il 
protocollo HTTP e non sono visibili sul navigatore. 

Una semplice verifica può essere eseguita modificando lo script ‘get_l.html’ nel seguente 
modo: 

0 <html> 

1 <head> 

2 <title> Passaggio del nome! </title> 

3 </head> 

4 

5 <body> 

6 

7 <br> 

8 Una semplice pagina HTML che passa nome e cognome ad 

9 uno script PHP che saluterà il navigatore. 

10 <brxbr> 

11 

12 <form method="post" action="get_2,php"> 

13 

14 Dimmi il tuo nome: <input type="Text" name="nome"> <brxbr> 

15 Ed ora il Cognome: <input type="Text" name="cognome"> <brxbr> 

16 

17 <input type="Submit" value="Adesso invia i dati in GET &gt;&gt;"> 

18 

19 </form> 

20 

21 </body> 

22 </html> 


Salvato come ‘post_l. html’ è possibile testarne il funzionamento e verificare che nella pag¬ 
ina ‘get_2 . php’ la barra degli indirizzi del programma di navigazione è priva delle coppie di 
variabili, allo stesso tempo lo script ha funzionato e viene visualizzato il messaggio di saluto 
correttamente. 

Analizzando lo script ‘post_l. html’ si nota che l’unica modifica è quella alTattributo ‘method’ 
del marcatore ‘form’. 

3.3 Quale metodo scegliere? 

Non c’è una regola particolare per scegliere l’uno piuttosto che l’altro metodo. Possiamo dire che 
se la quantità di dati da inviare è grande è preferibile utilizzare il ‘post’. Il protocollo HTTP 
permette, tramite i form HTML, l’upload di file dall’elaboratore cliente a quello servente, in 
questi casi è bene utilizzare il metodo ‘post’. 

Nel file di configurazione del PHP (‘php. ini’) può essere definita sia la dimensione massima dei 
file che il servente accetterà tramite HTTP, sia la dimensione massima dei dati accettati tramite 
‘post’. Quest’ultimo valore può essere definito valorizzando la variabile ‘post_max_size’ nel 

‘php. ini’. 

Quando i dati da scambiare sono pochi e non importa che risultino direttamente visibili si può 
utilizzare il metodo ‘get’, che è comodo anche per quelle situazioni in cui si utilizza spesso 
il tasto avanti e indietro del navigatore. Le variabili sono memorizzate insieme all’indirizzo e 
quindi ogni volta che si richiama una pagina ad essa vengono rifornite le variabili e i loro valori. 
Per rendersi conto di questo basta tenere d’occhio la barra degli indirizzi durante le ricerche su un 
qualunque motore di ricerca, il 99% di essi passano i dati tramite il metodo ‘get’. È altrettanto 
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vero che i dati passati al motore per le ricerche sono decisamente pochi, di solito si tratta di una 
stringa con dei parametri che il motore aggiunge automaticamente. 


3.4 Cosa è cambiato nel PHP versione 4.2 


Dalle versioni del PHP 4.2 e successive la gestione delle variabili passate tramite moduli 
HTML è sensibilmente cambiata. Nel file di configurazione viene valorizzata a vero la variabile 
track_vars , in questo modo tutte le variabili presenti in un modulo ed inviate ad uno script PHP 
vengono inserite in un array associativo contenente il nome delle variabile e il relativo valore. 

Ad esempio nel caso dello script ‘get_2 . php’ visto nelle sezioni [3~Ì~l c l3.2l si avrebbe la necessità 
di distinguere il metodo di invio. Più precisamente nel caso di un invio tramite metodo ‘get’ il 
file ‘get_2 .php’ dovrebbe essere così modificato: 

0 <html> 

1 <head> 

2 <title> Pagina di destinazione... </title> 

3 </head> 

4 

5 <body> 

6 

7 Ciao, <brxbr> 

8 

9 II tuo nome è: <?=$HTTP_GET_VARS["nome"]?> <br> 

10 e il tuo cognome è: <?=$HTTP_GET_VARS["cognome"]?> 

11 

12 </body> 

13 </html> 


Le differenze sono lampanti e riguardano le righe 9 e 10. L’interprete prende il valore rice¬ 
vuto dalla variabile predefinita $HTTP_GET_VARS che come detto in precedenza è un array 
associativo 

Nel caso di un invio tramite metodo ‘post’ il programma andrebbe così modificato: 

0 <html> 

1 <head> 

2 <title> Pagina di destinazione... </title> 

3 </head> 

4 

5 <body> 

6 

7 Ciao, <brxbr> 

8 

9 II tuo nome è: <?=$HTTP_POST_VARS["nome"]?> <br> 

10 e il tuo cognome è: <?=$HTTP_POST_VARS["cognome"]?> 

11 

12 </body> 

13 </html> 


Questo tipo di gestione delle variabili può sembrare prolissa ma evita confusioni all’interprete e 
costringe il programmatore a specificare la variabile su cui operare. 

Ovviamente se si hanno pagine sviluppate secondo le vecchie specifiche basterà settare a falso la 
variabile track_vars nel file di configurazione del PHP, in questo modo tutto dovrebbe funzionare 
correttamente. 
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Una funzione può essere intesa come un "sotto-programma" a cui si possono fornire dei valori 
per ottenere una risposta da essi dipendente o meno. 

Il PHP mette a disposizione degli sviluppatori una vasta gamma di funzioni predefinite, tuttavia 
in alcune situazioni è necessario eseguire operazioni particolari, in questi casi è possibile definire 
delle funzioni personali che si comportano secondo le proprie necessità. 

Si prenda d’esempio lo script del paragrafo 12.3.51 in cui si visualizzava la data formattata in un 
modo particolare, è improponibile dover scrivere 38 righe di codice ogni volta che si desidera 
visualizzare la data all’interno di una pagina HTML in questo caso la soluzione migliore è realiz¬ 
zare una funzione dedicata che restituisce la data mediante una semplice "chiamata". Per evitare 
errori e ripetitive modifiche è consigliabile realizzare uno o più file in cui raccogliere le funzioni 
personali più utilizzate, una sorta di libreria, da premettere in ogni pagina tramite il costrutto 
‘include () ’. 

4.1 Le funzioni predefinite 

Come detto in principio non è volontà dell’autore riportare l’elenco delle funzioni PHP, esse sono 
catalogate ed abbondantemente illustrate nel manuale ufficiale reperibile al sito internet: <Attp;Jjj 
www.php.net>. 

Di seguito si vuole illustrare la struttura del manuale e il modo in cui esso va consultato per 
cercare, scegliere ed infine utilizzare le innumerevoli funzioni predefìnite del linguaggio. Come 
sempre il modo migliore è l’utilizzo di un semplice esempio. Si supponga di voler realizzare uno 
programma che visualizzi una porzione di una stringa. Bisogna come prima cosa individuare le 
funzioni che permettono di manipolare le stringhe. 

Nella sezione "IV. Guida Funzioni" sono catalogate le funzioni messe a disposizione del program¬ 
matore, esse sono raggruppate per argomento. La sottosezione "LXXXIII. String functions" con¬ 
tiene le funzioni dedicate alla gestione delle stringhe. Come prima cosa si trova una descrizione 
della sezione e poi un lungo elenco, in ordine alfabetico, di funzioni con accanto una breve ma 
molto intuitiva descrizione. La funzione ‘substrO’ potrebbe risolvere il problema sollevato 
nell’esempio. 

Nel primo blocco della pagina descrittiva si trova il nome della funzione subito seguito dalle 
versioni dell’interprete PHP che la gestiscono e da una breve descrizione. Nel caso particolare: 


substr 

(PHP 3, PHP 4 >= 4.0.0) 

substr -- Return part of a string 


A seguire la descrizione approfondita che inizia con una delle parti più importanti della documen¬ 
tazione, infatti, in una sola riga viene spiegato l’intero funzionamento del comando. Nell’esempio 
proposto: 

string substr (string string, int start [, int length]) 


Come detto questa è forse la parte più importante, la prima parola descrive il tipo di dato restituito 
dalla funzione, nel caso particolare ‘string’, dunque la funzione restituisce una stringa. Dopo il 
nome della funzione tra parentesi i valori che la funzione può accettare ed il relativo tipo di dato, 
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va sottolineato che tra parentesi quadre vengono elencati i parametri non obbligatori e il relativo 
tipo di dato. 

Nel particolare la funzione accetta un primo dato di tipo stringa, separato da virgola il numero del 
carattere di partenza di tipo intero (si parte sempre da 0 e non da 1) ed infine come dato opzionale 
la lunghezza, di tipo intero, della porzione di stringa da estrarre. 

A questo schema seguono una descrizione approfondita ed una serie di esempi di funzionamen¬ 
to. Gli esempi se presenti sono molto utili ed autoesplicativi, inoltre trattano varie eccezioni ed 
eventuali casi particolari. 

In fine ma non meno importante la sezione contenente le funzioni correlate o in qualche modo 
relazionate con quella in oggetto. Il manuale spesso suggerisce di consultare anche altre funzioni, 
in questo caso: 

See also strrchr() and ereg(). 


Spesso non esiste un unico modo per raggiungere la soluzione del problema e spesso questa 
ultima sezione fornisce degli spunti molto interessanti che possono portare ad una soluzione più 
semplice e brillante, il consiglio è di non sottovalutarla. 

A questo punto è doveroso trattare almeno un esempio di utilizzo della funzione scelta come 
campione. 


o <? 

ì 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 ?> 


// La stringa iniziale va in $var 

$var = "Questa è la stringa di partenza"; 

// 0123456789012345678901234567890 

// 1234567890 

// Le due righe superiori semplificano il conteggio dei caratteri. 

// Questo esempio prende la parte: "la strìnga" 

$sub = substr($var, 9, 10); 

echo $sub; 

// Per selezionare gli ultimi 2 caratteri basta usare: 

$sub = substr($var, -2); 
echo "<brxbr> ".$sub; 

// Per selezionare i primi 2 caratteri basta usare: 

$sub = substr($var, 0, 2); 
echo "<brxbr> ".$sub; 

// Se non specifico la lunghezza della porzione continua fino alla fine 
$sub = substr($var, 5); 
echo "<brxbr> ".$sub; 


Il risultato di questo semplice script è simile a: 

la stringa 
za 

Qu 

a è la stringa di partenza 

Anche questo esempio è raggiungibile aU’indirizzo: <hup:,"www.urcanet.it'brdp. , ?hp_manual,';sempi/ 
cap_4/ìubstr.php > 
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4.2 Le funzioni definite dall'utente 


Un modo molto semplice di schematizzare il concetto di funzione è pensare ad una scatola che 
permette tramite due fori di inserire ed estrarre dei valori. All’interno della scatola può essere 
utilizzato qualunque costrutto messo a disposizione dal linguaggio, ecco perchè si parla di "sotto¬ 
programmi". Lo schema di figura l4~T1 può essere di aiuto. 

Figura [4J] Il blocco di programma principale contiene due scatole (funzioni) che 
ricevono due valori e restituiscono in un caso la somma, in un altro la differenza. 


$x, $y „ 

function 

differenza 

$ z=$x-$ y 

$ z 



u 





Proqramma Principale 



$x, $y, $z 

A 

7 


function 
somma 


$z=$x+$y $ z 


L’esempio classico è quello di una semplice funzione di saluto: 


$y 


0 <? 


1 //-Definizione delle funzioni 

2 

3 function saluto($ora){ 

4 

5 /* 

6 Questa funzione genera un messaggio di saluto 

7 in base al valore della variabile $ora passatagli 

8 che contiene l'ora, con valore tra 0 e 24 

9 */ 

10 

11 if (5 < $ora && $ora <= 12){ 

12 echo "Buon Giorno."; 

13 jelseif(12<$ora && Sora <= 18){ 

14 echo "Buon Pomeriggio."; 

15 jelseif(18<$ora && Sora <= 24){ 

16 echo "Buona Sera!"; 

17 }else{ 

18 echo "Guarda che razza di ora è! Ma quando dormi?!"; 

19 } 

20 } 

21 

22 

23 //-Programma principale 


24 

25 Sorario = date("H"); // estraggo l'ora attuale 

26 

27 // Richiamo la funzione e ci aggiungo del testo... 

28 
29 


saluto(Sorario); 
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30 echo " Come va oggi?!?"; 

31 

32 // non serve riscrivere il codice posso inserire 

33 //il saluto con una sola RIGA di codice! ! ! 

34 

35 echo "<brxbr> Ancora un saluto: saluto($orario) ; 

36 ?> 


Lo script è costituito da una parte contenente le dichiarazioni delle varie funzioni, nel caso speci¬ 
fico una sola, e dal programma principale che le richiama una o più volte. Come prima cosa è 
importante eseminare la sintassi per la dichiarazione delle funzioni. 

function nome_funzione(variabile_l, variabile_2, .... , variabile_n){ 

istruzioni funzione 

return valore se necessario 

} 


Il costrutto "function’ segna l’inizio della dichiarazine, subito dopo va assegnato un nome che 
deve essere unico nel programma, non possono esserci più funzioni aventi lo stesso nome, tra par¬ 
entesi tonde è possibile elencare le variabili, se esistono, che devono essere fornite alla funzione, 
se sono più di una vanno separate da una virgola (‘, ’). Il colpo della funzione è, infine, contenuto 
tra parentesi graffe (‘ {. . . } ’). 

Una volta dichiarata, la funzione, può essere richiamata tutte le volte che si vuole, è questo il van¬ 
taggio che si ha nel suddividere il lavoro in piccoli problemi e a risolverli con piccoli e semplici 
sotto-programmi da richiamare ogni volta che se ne ha bisogno. 

Come detto la funzione può restituire dei valori, dunque quando richiamata può essere vista come 
una variabile contenente dei valori. Se si modifica l’esempio precedente come riportato di seguito, 
la funzione non scriverà nulla sullo schermo ma valorizzerà tramite il comando ‘return’ il nome 
della funzione, esso potrà essere visualizzato, assegnato ad un’altea variabile, ecc... Proprio come 
fosse una variabile. 

o <? 


1 //-Definizione delle funzioni 

2 

3 function saluto($ora){ 

4 

5 /* 

6 Questa funzione genera un messaggio di saluto 

7 in base al valore della variabile ricevuta $ora 

8 che contiene l'ora con valore tra 0 e 24 

9 e lo restituisce al programma principale tramite 

10 l'istruzione "return" 

11 */ 

12 

13 if (5 < $ora && $ora <= 12){ 

14 return "Buon Giorno."; 

15 jelseif(12<$ora && Sora <= 18) { 

16 return "Buon Pomerìggio."; 

17 jelseif(18<$ora && Sora <= 24){ 

18 return "Buona Sera!"; 

19 }else{ 

20 return "Guarda che razza di ora è! Ma quando dormi?!"; 

21 } 

22 } 

23 
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24 //-Programma principale 

25 

26 $orario = date("H"); 

27 

28 // Richiamo la funzione e ci aggiungo del testo... 

29 

30 $msg = saluto ($orario); // assegno il valore della funzione 

31 echo $msg." Come va oggi?!?"; 

32 

33 // una sola RIGA di codice CONCATENATO come fosse una variabile 

34 

35 echo "<brxbr> Ancora un saluto: ". saluto ($orario) ; 

36 

37 ?> 


Le modifiche adottate nelle righe 14, 16, 18, 20 provvedono tramite il comando ‘return’ ad as¬ 
segnare un valore al nome della funzione invece di visualizzarlo sullo schermo. Di conseguenza 
cambia il modo di manipolare la funzione al momento della chiamata, infatti, in questo modo ri¬ 
torna un valore che può essere trattato come una semplice variabile. Nella riga 30 viene assegnato 
il valore restituito dalla funzione ad un’altra variabile, mentre nella riga 35 viene concatenato in 
una stringa. 

A questo punto si potrebbe avere la necessità di scegliere se far visualizzare il messaggio diret¬ 
tamente dalla funzione o farlo ritornare come valore. Complicando leggermente l’esempio si può 
risolvere il problema. Una semplice soluzione è quella di passare una seconda variabile, che a 
seconda del suo stato (vero o falso) fa comportare la funzione in due modi diversi. 

o <? 


1 //-Definizione delle funzioni 

2 

3 function saluto($ora, $modo){ 

4 

5 /* 

6 Questa funzione genera un messaggio di saluto 

7 in base al valore della variabile ricevuta $ora 

8 che contiene l'ora con valore tra 0 e 24 

9 e lo restituisce al programma principale tramite 

10 l'istruzione "return" se $modo è falso, se è vero 

11 ne visualizza il valore. 

12 */ 

13 

14 ìf (5 < $ora && $ora <= 12){ 

15 $msg = "Buon Giorno."; 

16 jelseif(12<$ora && Sora <= 18){ 

17 $msg = "Buon Pomeriggio."; 

18 jelseif(18<$ora && Sora <= 24){ 

19 $msg = "Buona Sera!"; 

20 }else{ 

21 $msg = "Guarda che razza di ora è! Ma quando dormi?!"; 

22 } 

23 

24 // controllo sul flag $modo. 

25 if($modo){ 

26 echo $msg; 

27 }else{ 

28 return $msg; 

29 } 

30 

31 } 

32 

33 //-Programma principale 

34 
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35 $orario = date("H"); 

36 $modo = false; 

37 

38 // Richiamo la funzione e ci aggiungo del testo... 

39 $msg = saluto($orario, $modo); 

4 0 echo $msg." Come va oggi? ! ?" . "<brxbr>"; 

41 

42 // Adesso posso anche farlo scrivere direttamente, ecco come: 

43 saluto($orario, 1); 

44 ?> 


Adesso la funzione si aspetta due parametri, il primo serve a generare il messaggio di saluto, il 
secondo (righe 25-29) a determinare il comportamento della funzione. Se cambia la dichiarazione 
deve cambiare anche la chiamata alla funzione, infatti, nelle righe 39 e 43 vengono passati i due 
parametri e la funzione si comporta di conseguenza. 


Quando si richiama una funzione non importa il nome delle vai'iabili che gli vengono fornite, 
quello che importa è l’ordine con cui esse vengono elencate. 


Dunque i valori passati alla funzione andranno nelle variabili locali (della funzione) definite 
al momento della dichiarazione della stessa. Nell’esempio seguente viene approfondito questo 
aspetto tramite una funzione che genera e visualizza una scheda informativa di un potenziale 
utente. 

o <? 

1 //-Definizione delle funzioni 

2 

3 function scheda($nome, $cognome){ 

4 

5 /* 

6 Questa funzione ha 

7 variabile locale e 

8 all'ordine con cui 

9 */ 

10 

11 global $tel; 

12 

13 echo 

14 echo 

15 echo 

16 echo 

17 echo 

18 echo 

19 } 

20 

21 //-Programma principale 

22 

23 $nome = "Gianluca"; 

24 $cognome = "Giusti"; 

25 $tel = "06/66666666"; 

26 $email = "brdp @ urcanet.it"; 

27 

28 // richiamo la funzione che genera la scheda. 

29 scheda($nome, $cognome); 

30 

31 // il nome delle variabili non importa! Importa invece l'ordine 

32 // con cui vengono passate alla funzione! Ecco la prova: 

33 scheda($cognome, $nome); 

34 ?> 


"<br>Scheda informativa utente: <brxbr> " 
"<br>Nome: ".$nome; 

"<br>Cognome: ".$cognome; 

"<br>Telefono: ",$tel; 

"<br>e-mail: ".$email; 

"<brxbr>-<br>" ; 


lo scopo di chiarire il concetto di 
globale. Fare inoltre attenzione 
sono passate le variabili 
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Come detto in principio, le funzioni sono dei piccoli programmi a se stanti, dunque le variabili 
utilizzate al loro interno, dette "variabili locali", non hanno lo stesso valore di quelle utilizzate 
nel programma principale, dette "variabili globali" anche se nominate allo stesso modo. Si può 
dire che sono vai'iabili diverse. Un modo per far coincidere le variabili locali e globali è passare 
le variabili globali come argomento della funzione, proprio come fatto negli esempi precedenti. 
Un secondo metodo, è l’utilizzo del comando "global’. Nella riga 11 dell’esempio precedente 
viene utilizzato per "catturare" il valore della variabile globale $tel all’interno della funzione. 

Il risultato dell’ultimo programma è simile a: 

Scheda informativa utente: 

Nome: Gianluca 
Cognome: Giusti 
Telefono: 06/66666666 
e-mail : 


Scheda informativa utente: 

Nome: Giusti 
Cognome: Gianluca 
Telefono: 06/66666666 
e-mail : 


Come prima cosa va notata l’assenza dell’indirizzo e-rnail, questo dipende dal fatto che la vari¬ 
abile $email non è stata fornita in alcun modo alla funzione quindi al suo interno non è val¬ 
orizzata. Al contrario le altre variabili sono valorizzate, $nome e $cognome vengono passate al 
momento della chiamata mentre la variabile $tel viene associata a quella globale. 

L’utilizzo di ‘global’ non è consigliabile dal momento che ogni modifica alla variabile utilizzata 
come globale all’interno della funzione si riperquote anche nel programma principale. Se non si 
hanno motivi particolari non ha senso utilizzare questo metodo. 

Un ottimo esercizio per l’utente è la verifica di quanto appena detto. Modificare l’ultimo esempio 
al fine di dimostrare che le modifiche alla variabile $tel effettuate all’interno della funzione si 
riperquotono anche nel programma principale, mentre eventuali modifiche alle variabili passate 
come argomento all’interno della funzione non hanno effetto nel programma principale. 

Per i più esperti la situazione è simile al passaggio di variabili per "valore" o per "riferimento". 

La funzione, inoltre, viene richiamata due volte invertendo l’ordine dei parametri a dimostrazione 
che il nome delle variabili non ha alcun importanza ma quello che importa è l’ordine con cui 
vengono dichiarate e passate al momento della chiamata. 

In conclusione il modo migliore e più elegante per realizzare la scheda utente dell’esempio è 
fornire tutti i dati necessari alla funzione come parametri della chiamata. 

o <? 

1 //-Definizione delle funzioni 

2 

3 function scheda($nome, $cognome, $tel, $email){ 

4 

5 // Il modo più corretto è il passaggio delle variabili 

6 // Salvo casi particolari in cui si è obbligati ad usare il global 

7 

8 echo "<br>Scheda informativa utente: <br><br> 

9 echo "<br>Nome: ",$nome; 
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10 echo "<br>Cognome: ".$cognome; 

11 echo "<br>Telefono: ",$tel; 

12 echo "<br>e-mail: ".$email; 

13 echo "<brxbr>-<br>"; 

14 } 

15 

16 

17 //-Programma principale 

18 

19 $nome = "Gianluca"; 

20 $cognome = "Giusti"; 

21 $telefono = "06/66666666"; 

22 $posta_elettronica = "brdp @ urcanet.it"; 

23 

24 // richiamo la funzione che genera la scheda. I nomi non contano! 

25 scheda($nome, $cognome, $telefono, $posta_elettronica); 

26 

27 ?> 


Uno degli aspetti più importanti di un sito Internet è l’estetica ed è anche la parte che viene 
rinnovata più di frequente. Si pensi alla necessità di elencare degli oggetti secondo particolari 
vesti grafiche, utilizzando una funzione è possibile modificare varie pagine, in cui essa viene 
richiamata, modificando una sola porzione di codice. Un altro esempio è dato dai siti in cui è 
possibile personalizzare la formattazione dei dati tramite la scelta di modelli predefìniti, in questo 
caso la funzione potrebbe ricevere un parametro in più che rappresente il modello, oppure si 
potrebbero implementare varie funzioni che formattano i medesimi dati in modo differente. 

Come conclusione si può senza dubbio affermare che un programma strutturato è molto più 
leggibile ed elegante di uno costituito da un unico blocco di codice spesso incomprensibile. 

In fine va notato che ci sono delle operazioni che vengono ripetute spesso nel lavoro di tutti i 
giorni, ad esempio formattazione della data in vari formati, connessione e interrogazioni di basi 
di dati, paginazione di elenchi, gestione di immagini, upload di file, ecc... La cosa più intelligente 
è creare dei file, paragonabili a librerie, contenenti le dichiarazioni delle funzioni più utilizzate, 
a questo punto basterà includere tali "librerie" in cima agli script in modo da poter richiamare 
le funzioni senza dovrele dichiarare ogni volta. Ancora più corretto è la creazione di "librerie" 
contenenti delle classi con cui poter dichiarare dei veri e propri oggetti ma questo verrà spiegato 
nella sezione dedicata alla programmazione avanzata. 

Un esercizio interessante lasciato al lettore è quello di implementare una funzione chiamata 
‘isint ( $var) ’, supponendo che non esista la funzione già vista ‘is_integer () ’, che utiliz¬ 
zando ‘gettype () ’ restituisca un valore vero se la variabile passata è un intero o falso se la 
variabile è di un altro tipo. 

4.3 Le funzioni ricorsive 

Il PHP permette di richiamare le funzioni in modo ricorsivo, ovvero è possibile richiamare una 
funzione dal suo interno. Un classico esempio applicativo di questa tecnica è il calcolo del 
fattoriale. Come noto il fattoriale di un numero intero positivo n (indicato come n!) è pari a 
n*(n-l)*(n-2)*...*(n-(n-l)) . Ad esempio: 

5/ = 5 *4*3 *2*1 = 120 

Ecco come risolvere il problema con l'utilizzo di una funzione ricorsiva: 

0<htmlxbody> 

1 <? 

2 //-Definizione delle funzioni 
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3 

4 function fattoriale($numero){ 

5 

6 if($numero <= 1){ 

7 return 1; // abbandona la ricorsione 

8 }else{ 

9 return $numero*fattoriale($numero-l) ; //la funzione richiama se stessa 

10 } 

11 

12 } 

13 

14 

15 //-Programma principale 

16 

17 echo "<br>Calcolo del fattoriale :<br>"; 

18 

19 for($i=—2 ; $i<=10; $i + + ){ 

20 echo "<br>Il fattoriale di $i è: fattoriale($i); 

21 } 

22 

23 ?> 

24 

25 </body></html> 

All’interno della dichiarazione, riga 9, viene richiamata la funzione stessa passandogli il numero 
decrementato di uno. Questo perchè n! = n*(n-l)! = n*(n-l)*(n-2)! e così via... Il fattoriale di 0 
è pari ad 1 per definizione. Per semplificare il controllo si è stabilito che il fattoriale di un numero 
negativo è pari ad 1 anche se non è cornetto matematicamente. 

L’attenzione non deve essere focalizzata sull’aspetto matematico ma sul fatto che la funzione 
nel programma principale viene richiamata una sola volta. Ancora più importante in problemi 
di questo genere è la definizione di una condizione di arresto, in questo caso quando il numero 
passato alla funzione è ‘<=1’ la funzione abbandona la ricorsione e restituisce valore pari ad 1. Se 
si sbaglia o si tralascia la condizione di uscita il programma potrebbe entrare in un ciclo infinito 
e non smetterebbe mai l’esecuzione. 
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Capitolo 


La gestione del file System 

Il file System è ben gestito dal PHP, le funzioni a disposizione degli sviluppatori sono 
innumerevoli, inoltre sono ben integrate con il sistema operativo in modo particolare GNU/Linux. 

Ad esempio è possibile ottenere e cambiare i permessi, il proprietario e il gruppo di un file, 
creare collegamenti simbolici, copiare, spostare, eliminale directory e file. Dunque gli strumenti 
a disposizione non mancano e molti di essi verranno Pattati nelle pagine seguenti. 

Prima di entrale nello specifico è bene precisare ancora una volta che il file System su cui il PHP 
opera è quello dell’elaboratore servente, quindi se si crea un file esso viene creato sul disco del 
servente e non su quello del cliente. 

Tramite il protocollo HTTP il PHP può gestire anche il trasferimento di file dall’elaboratore 
cliente a quello servente, questo però verrà trattato nella sezione dedicata alla programmazione 
avanzata. 

5.1 Concetto di file 

Un file può essere visto come un contenitore nel quale immagazzinare informazioni. La gestione 
fisica del file su disco viene effettuata dal sistema operativo a cui si interfaccia il PHP. 

Per poter accedere alle informazioni contenute in un file è necessario aprirlo, leggerne il 
contenuto, eventualmente modificarlo e infine chiuderlo. 

I dati vengono salvati nel file sotto forma di righe, per indicare il fine riga nei file di testo viene 
utilizzato ‘\n’, mentre la fine del file è ottenuta tramite la funzione ‘feof () ’ che restituisce un 
valore booleano vero se ci si trova alla fine del file. 

La particolarità fondamentale di questa struttura è il suo accesso, a differenza degli array non 
è possibile puntare direttamente ad una riga ben precisa del file è dunque necessario scorrere il 
suo contenuto fino ad arrivare alla riga desiderata. Questo tipo di accesso viene detto "accesso 
sequenziale". 

Non ci sono, inoltre, limiti massimi o minimi per le dimensioni del file, esse dipendono dalla 
disponibilità di spazio su disco. 

5.2 Apertura di un file 

Se un file è un contenitore per poter accedere al suo contenuto è necessario aprirlo, per farlo si 
utilizza la funzione ‘fopen () ’ a cui va fornito il file con il percorso, se diverso da quello dello 
script, e il tipo di apertura. Dunque al momento dell’apertura del file bisogna dichiarare il tipo 
di operazione che si desidera eseguire su di esso, ad esempio se si vuole solo leggere, scrivere o 
semplicemente aggiungere dati alla fine. Ecco l’elenco dei possibili modi di accedere ad un file 
in PHP: 


• ‘ ' r ' ’ Apre in sola lettura; posiziona il suo puntatore all’inizio del file; 

• ‘ ' r+' ’ Apre in lettura e scrittura; posiziona il suo puntatore all’inizio del file; 

• *' w' ’ Apre in sola scrittura; posiziona il suo puntatore alTinizio del file e ne elimina il 
contenuto. Se il file non esiste lo crea; 

• ‘ ' w+' ’ Apre in lettura e scrittura; posiziona il suo puntatore alTinizio del file e ne elimina 
il contenuto. Se il file non esiste lo crea; 
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• ‘ ' a ' ’ Apre in sola scrittura; posiziona il suo puntatore alla fine del file. Se il file non esiste 
lo crea; 

• *' a+' ’ Apre in lettura e scrittura; posiziona il suo puntatore alla fine del file. Se il file non 
esiste lo crea; 


Il PHP permette anche di aprire file remoti tramite i protocolli più diffusi come HTTP e FTP, 
ovviamente il file deve essere raggiungibile almeno in lettura. 

Ecco qualche esempio di apertura di file: 


o $f 

1 $f 

2 $f 

3 $f 


fopen ("dati.txt", "w"); 

fopen ("/home/qualche_percorso/dati.txt" , "a"); 
fopen ("http://www.php.net/", "r"); 

fopen ( " ftp : //norae_utente :password@ indiri zzo_del_sito_ftp . corri/ ", "w" ) ; 


Va notato che la funzione ritorna un intero. La variabile '$f ’ contiene i riferimenti al file aper¬ 
to, viene anche detto "puntatore al file" anche se non ha nulla a che vedere con la "struttura 
puntatore". Tutte le operazione sarnno eseguite sul puntatore al file. 

Nella riga 0 il file viene aperto in sola scrittura un file che si trova nella stessa directory dello 
script, se non esistere viene creato. Nella riga 1 il file viene aperto in un ben preciso punto del del 
disco del servente. Negli ultimi due esempi i file aperti risiedono in remoto e sono aperti tramite 
i due protocolli HTTP ed FTP 


Fare molta attenzione ai permessi dei file che si intende manipolare e delle directory in cui 
sono contenuti. Ricordare che l’utente che accede al file è quello che lancia il servente HTTP 
e di conseguenza l’interprete PHP in esso caricato come modulo. Tale utente viene specificato 
nel file di configurazione del servente. 


5.3 Lettura di un file di testo 


Il primo passo sarà quello di leggere un semplice file di testo esistente e contenuto nella stessa 
directory dello script. Verrà utilizzato il metodo di sola lettura con l’indispensabile controllo di 
errore e ancora prima di esistenza del file da leggere. Se si salvano informazioni riservate in 
file di testo è bene farlo in una directory che non faccia parte dei documenti WEB altrimenti 
potrebbe essere richiamato e letto direttamente dal navigatore. Inoltre è importante nascondere 
eventuali errori mediante una corretta gestione degli stessi al fine di evitare la visualizzazione 
di informazioni importanti come il percorso e il nome del file che si tenta di aprire. Prima di 
scrivere il codice è bene creare il file da leggere, nominarlo come ‘dati_l. txt’ e riempirlo con 
del semplice testo. 

Un esempio di dati_l.txt: 

Salve a tutti, 

scrivo nel file per poi leggere con php. 

dì seguito una riga vuota 

e poi il file finisce! 


Ecco il programma che legge il file appena creato: 


0 <htmlxbody> 
1 
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2 <? 

3 if (file_exists("dati_l.txt")){ 

4 echo "Il file dati_l.txt esiste. Ecco il suo contenuto :<br>"; 

5 

6 $f = Sfopen("dati_l.txt", "r"); // apre il file in sola lettura 

7 if($f){ 

8 while(!feof($f)){ // un semplice while fino alla fine del file 

9 $riga = fgets($f,4096); // legge la riga 

10 echo "<br>".$riga; // visualizza la riga 

11 } 

12 @fclose($f); // è importante chiudere il file 

13 }else{ 

14 echo "Errore durante l'apertura del file!"; 

16 } 

17 

18 }else{ 

19 echo "Il file dati_l.txt NON esìste!"; 

20 } 

21 ?> 

22 

23 </body></html> 


Nella riga 3 viene controllata 1’esistenza del file di testo tramite la funzione ‘file_exists () ’ 
che come riportato nel manuale ufficiale alla sezione "XXVI. Filesystem functions" ritorna un 
valore booleano vero se il file esiste falso negli altri casi. Questa sezione del manuale è ricca di 
funzioni per la gestione dei file si consiglia vivamente di approfondirne la lettura. 

Alla riga 6 il file viene aperto in sola lettura è bene fare attenzione alla gestione dell’errore. Se 
l’apertura va a buon fine tramite una struttura ciclica ne viene visualizzato il contenuto. La lettura 
viene interrotta nel momento in cui la funzione ‘feof () ’ resituisce valore vero, questo accade 
quando si arriva alla fine del file. 

Per la lettura delle singole righe del file è stata utilizzata la funzione ‘fgets () ’ che restituisce 
una stringa o un valore falso in caso di errore. 

Molto importante è l’istruzione della riga 12 con la quale viene chiuso il puntatore al file definito 
nella fase di apertura. È bene liberare un file prima possibile per evitale problemi di scrittura 
concorrenziale. Anche questa funzione ritorna un valore booleano vero se l’operazione va a buon 
fine, falso altrimenti. 

Se il file di testo da leggere è piccolo si può utilizzare la funzione ‘file ( "nome_delJìle 
ovviamente oltre al nome del file può essere specificato un particolare percorso e il tutto può 
essere contenuto in una variabile da passare come parametro. La funzione ‘file ( ) ’ resituisce un 
array formato da tanti elementi quante sono le righe del file di testo, ogni elemento conterrà il 
testo della riga relativa. Ad esempio nel caso del precedente file ‘dati_l. txt’: 

0 <htmlxbody> 

1 

2 <? 

3 $appo = 0fileCdati_l.txt"); 

4 if ($appo){ 

5 echo "Operazione riuscita il contenuto del file dati_l.txt 

6 è nell'array <b>\$appo</bxbr>" ; 

7 $i=0; 

8 foreach($appo as $valore) // visualizzo il contenuto dell'array 

9 echo "<br>".$valore; 

10 

11 }else{ 

12 echo "Errore nella lettura del file! Accertarsi che 

13 esista e che i permessi siano corretti"; 

14 


} 
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15 

16 ?> 

17 

18 </body></html> 

Questa funzione risulta molto comoda e rapida inquanto non necessita di istruzioni per l’apertura 
e la chiusura del file. È evidente che in questo modo il contenuto può essere soltanto letto e non 
modificato. In caso di file di dimensioni medio grandi è preferibile utilizzare le funzioni classiche 
viste in precedenza che benché più macchinose garantiscono una migliore gestione del file e della 
memoria. 

5.4 Scrittura in un file di testo 

Come al solito prima di poter operare sul contenuto del file bisogna aprirlo, ovviamente per poter 
inserire dei dati nel contenitore bisogna aprirlo in modalità di scrittura. Come visto in precedenza 
esistono varie modalità e per ogni situazione va scelta quella ottimale. Di seguito esamineremo 
alcuni metodi di scrittura nel file. 

Il tipo ‘r+’ permette di leggere e scrivere nel file che si sta aprendo e posiziona il puntatore 
all’inizio del contenitore senza alterarne a priori il contenuto. È utile quando bisogna posizionare 
una riga in una ben precisa posizione del file. 

Nel caso di V e ‘w+’ il file viene aperto in scrittura o scrittura e lettura e viene immediatamente 
svuotato. Può essere comodo nel caso di file di appoggio che possono essere sovrascritti senza 
doverne controllare il contenuto. 

Il metodo di apertura ‘a’ e ‘a+’, che serve ad accodare righe al file, verrà trattato in dettaglio nel 
paragrafo [53] 

Nell’esempio seguente si salva nel file ‘dati_3.txt’ l’indirizzo IP dell’ultimo visitatore che 
ha caricato la pagina ‘3 .php’. Anche questo come tutti gli esempi di questo capitolo è raggiun¬ 
gibile al solito indirizzo: <http:/.'www.urcanet.it'brdp,'php_manuaL'ìsempi/> nel caso specifico: < http:// 
www. urcanet.iL l brdp/php_manuaI/ssempi/;ap_5/3.php> 

0 <htmlxbody> 

1 

2 <? 

3 $f = @fopen("dati_3.txt", "w"); // lo apre e lo svuota, se non esiste lo crea 

4 if($f){ 

5 echo "<brxbr>f±le <a href=\"datì_3.txt\">datì_3.txt</a> Aperto correttamente. 

6 echo "<brxbr>Sto salvando i tuoi dati nel file"; 

7 

8 $frase = "Ultimo visitatore ad aver eseguito lo script 3.php \n\n"; 

9 $frase = $frase."il suo IP :".$REMOTE_ADDR." \n"; 

10 

11 Sfputs($f,$frase); // scrive la frase nel file tramite $f 

12 @fclose($f); // è importante chiudere il file 

13 

14 echo ". Fatto!"; 

15 

16 }else{ 

17 echo "<br>Errore durante l'apertura del file dati_3.txt"; 

18 } 

19 ?> 

20 

21 </body></html> 


Nella riga 3 il file viene aperto in sola scrittura e come più volte ripetuto il suo contenuto viene 
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cancellato. Dunque questo codice sarà in grado di mantenere traccia soltanto dell’ultimo visita¬ 
tore. Sarebbe più interessante memorizzale più visite ma bisogna fare i conti con la crescita del 
file, se la pagina è molto frequentata le dimensioni del file di log potrebbero crescere a dismisura 
fino a saturare lo spazio su disco. Un buon esercizio potrebbe essere la realizzazione di uno script 
che tenga traccia degli ultimi ‘$n’ visitatori, dove ‘$n’ è un parametro che può essere impostato a 
seconda delle esigenze. 

Di seguito una possibile soluzione: 

0 <htmlxbody> 

1 <? 

2 $n = 4; // numero di visite da mantenere 

3 $f = @fopen("dati_4.txt" , "r"); 

4 

5 if($f){ 

6 

7 echo "<br>file dati_4.txt esistente ed aperto correttamente <br>"; 

8 $i=0; 

9 while ( !feof($f) && $i<$n-l ){ // finché fine del file o il $i< $n-l 

10 $righe[$i] = Sfgets($f,4096); // file piccolo! utilizzo array sacmbio 

11 $i++; 

12 } 

13 @fclose($f); // è importante chiudere il file 

14 

15 $f = @fopen("dati_4.txt", "w"); // adesso lo riempio con ì nuovi dati. 

16 if($f){ 

17 echo "<br><br>file <a href=\"dati_4.txt\">dati_4.txt</a> Aperto 

18 correttamente. Sto salvando ì tuoi dati"; 

19 

20 $frase = "visitatore di 4.php - "; 

21 $frase = $frase."il suo IP :".$REMOTE_ADDR." alle ore: ".date("d-m-Y G:i:s")." \n"; 

22 Sfputs($f,$frase); // scrive la frase nel file tramite $f 

23 

24 for ($i=0; $i<count($righe); $i+t) 

25 Sfputs($f,$rìghe[$i]); 

26 

27 @fclose($f); // è importante chiudere il file 

28 echo ".Fatto!"; 

29 } 

30 

31 }else{ 

32 

33 echo "<br>Il file dati_4.txt non esiste. Lo creo."; 

34 

35 $f = @fopen("dati_4.txt", "w"); 

36 

37 if($ f){ 

38 

39 echo "<brxbr>file <a href=\"dati_4.txt\">dati_4.txt</a> Aperto 

40 correttamente. Sto salvando i tuoi dati"; 

41 

42 $frase = "visitatore di 4.php - "; 

43 $frase = $frase."il suo IP :".$REMOTE_ADDR." alle ore: ".date("d-m-Y G:i:s")." \n"; 

44 

45 Sfputs ($f,$frase); // scrive la frase nel file tramite $f 

46 @fclose($f); //è importante chiudere il file 

47 

48 echo ".Fatto!"; 

49 

50 }else{ 

51 echo "<brxbr>Non posso creare il file dati_4.txt"; 

52 } 

53 } 

54 ?> 
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55 </body></html> 


Ci sono vari modi per risolvere il problema, quello usato per questo esempio è volutamente 
prolisso al fine di utilizzare più volte le funzioni sotto esame così da rendere più semplice 
l’apprendimento. 

Concettualmente si è ragionato in questi termini: 

se il file esiste 

{ 

- leggo le prime $n-l righe del file 

- le salvo in un array di appoggio 

- chiudo il file 

- apro il file in scrittura cancellandone il contenuto 

- salvo i dati relativi alla connessione attuale nel file 

- salvo tutte le righe dell'array di appoggio 

- chiudo il file 

} 

altrimenti 

{ 

- apro il file in scrittura e viene creato 

- salvo i dati relativi alla connessione attuale nel file 

- chiudo il file 

} 


in realtà non viene fatto un controllo sull’esistenza del file ma si è considerato che se non si riesce 
ad aprire in sola lettura con il metodo ‘r’ il file o non esiste o non è leggibile. 

Nel ciclo di riga 9 vengono prese le prime ‘$n-l’ righe del file o tutto il file se ha meno di ‘$n’ 
righe, la condizione che per prima non viene soddisfatta fa abbandonare il ciclo. 

Nelle righe 21 e 43 è stata usata la variabile predefinita ‘$REMOTE_ADDR’ che contiene l’indirizzo 
IP del visitatore e di seguito la funzione ‘date () ’ già incontrata nalla sezione [Tj]che in questo 
caso ritorna la data nella forma del tipo: ‘31-10-2002 15 :13:13’. Maggiori informazioni in 
merito possono essere trovate nella sezione "XVI. Date and Time functions" del manuale ufficiale. 

In fine nella righa 24 al posto della solita struttura ‘foreach’ è stata utilizzata volutamente la 
funzione ‘count () ’ che restituisce il numero di elementi dell’array che gli viene passato come 
parametro. 

In conclusione va notato che l’ultima visita verrà registrata in testa al file mentre le più vec¬ 
chie verranno scartate mano a mano che ne entreranno delle nuove. Il risultato ottenuto nel file 

‘dati_4 . txt’ è simile a: 

visitatore di 4.php - il suo IP : 192.168.1.153 alle ore: 31-10-2002 15:13:24 

visitatore dì 4.php - il suo IP : 192.168.1.153 alle ore: 31-10-2002 15:13:17 

visitatore di 4.php - il suo IP : 192.168.1.153 alle ore: 31-10-2002 15:13:12 

visitatore dì 4.php - il suo IP : 192.168.1.153 alle ore: 31-10-2002 15:10:21 


Come conclusione viene proposto un esempio riepilogativo in merito al quale non verranno for¬ 
nite spiegazioni, sarà compito del lettore capirne il comportamento. Per testarne il funzionamento 
è tuttavia possibile collegarsi all’indirizzo: <http:, '.'www.urcanet.it, 'brdp/ohp_manuaL';sempi,':ap_5/5.php> 

0 <htmlxbody> 

1 <? 

2 /* 

3 Primo tentativo di apertura del file inesistente dati_5.txt in sola lettura 

4 il tentativo di apertura fallisce perchè la modalità ' r' non 

5 crea il file in caso di inesistenza, a differenza delle modalità 

6 'w' e 'a' che se non esiste lo creano. Quindi il controllo seguente 
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7 restituirà il messaggio di errore... 

8 */ 

9 

10 $f = @fopen("dati_5.txt" , "r") ; 

11 

12 if($ f){ 

13 echo "<br>l) file dati_5.txt Aperto. Ecco il contenuto: <br>"; 

14 //Se apre il file facciamo scrivere il contenuto 

15 while(!feof ($f)){ // finché non raggiungo la fine del file 

16 $riga = Sfgets($f,4096); 

17 echo "<br>".$riga; 

18 } 

19 @fclose($f); // è importante chiudere il file 

20 }else{ 

21 echo "<br>l) Apertura del file dati_5.txt FALLITA! Ora lo creo e lo riempio. 

22 } 

23 

24 /* 

25 Secondo tentativo apro in sola scrittura il file 

26 il tentativo di apertura riesce perchè la modalità 'w' 

27 crea il file in caso di inesistenza. Il controllo seguente 

28 restituirà messaggio positivo. 

29 ATTENZIONE in questo caso il file viene svuotato al momento 

30 dell'apertura, il contenuto viene perso. 

31 */ 

32 

33 ìf (!file_exists("dati_5.txt")){ 

34 

35 $f = Sfopen("dati_5.txt", "w"); 

36 if($f){ 

37 

38 echo "<brxbr>2) file dati_5.txt Aperto correttamente. Lo riempio"; 

39 

40 // sappiamo che va a buon fine e quindi scriviamoci qualcosa dentro. 

41 // notare che \n inserisce un fine riga! ! ! 

42 $frase = "Ciao Popolo. \n"; 

43 $frase = $frase."Scrivo nel mio primo file in PHP \n"; 

44 $frase = $frase."Speriamo bene! \n"; 

45 $frase = $frase."CIAO"; 

46 

47 Sfputs($f,$frase); // scrive la frase nel file tramite $f 

48 @fclose($f); // è importante chiudere il file 

49 

50 }else{ 

51 echo "<brxbr>2) Apertura del file dati_5.txt <strong>FALLITA!</strong>"; 

52 } 

53 

54 }else{ 

55 

56 echo "<brxbr>2) Il file dati_5.txt esiste già. Allora lo RIMUOVO!"; 

57 if(@unlink ("dati_5.txt")){ 

58 echo "<brxbr> FILE dati_5.txt RIMOSSO CORRETTAMENTE"; 

59 }else{ 

60 echo "<brxbr> ERRORE durante la rimozione di dati_5.txt"; 

61 } 

62 } 

63 ?> 

64 </body></html> 


In questo ultimo esempio viene utilizzata per la prima volta la funzione "unlink ( ) ’ che serve ad 
eliminare il file che riceve come parametro, essa restituisce un intero che assume valore pari a 0 
o falso se l’operazione di cancellazione non va a buon fine. 
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5.5 Accodare testo in un file 


Ovviamente esistono metodi più semplici, immediati e dunque migliori per tenere traccia di 
qualunque evento. Prima di continuare è bene ricordare che il servente HTTP memorizza in file di 
log le informazioni relative alle connessioni quindi se non si hanno particolari esigenze tracciare 
le visite degli utenti potrebbe essere un’operazione ridondante. 

Il PHP come visto nella sezione I5T21 permette di aprire un file in modalità "append", ovvero in 
modo che le righe inserite vengano appese alla fine del file, questo metodo è utilizzabile passando 
alla funzione ‘fopen () ’ il parametro ‘a’ o ‘a+\ nel primo caso il file viene aperto in sola scrittura 
mentre nel secondo in scrittura e lettura, il puntatore viene posizionato alla fine del file e se non 
esiste il file specificato viene creato. 

Se si pensa al problema affrontato precedentemente (sezione 15.41 ) ci si rende immediatamente 
conto che utilizzando questo metodo di scrittura nel file si possono accodare le informazioni 
utilizzando poche righe di codice. Ad esmpio: 

0 <htmlxbody> 

1 

2 <? 

3 $f = @fopen("dati_6.txt", "a"); //apre in scrittura, se non esiste lo crea 

4 if($f){ 

5 echo "<br><br>file <a href=\"dati_6.txt\">dati_6.txt</a> Aperto."; 

6 echo "<brxbr>Sto salvando i tuoi dati nel file"; 

7 

8 $frase = "visitatore di 6.php - "; 

9 $frase = $frase."il suo IP :".$REMOTE_ADDR." alle ore: ".date("d-m-Y G:i:s")." \n" 

10 

11 Sfputs($f,$frase); // scrive la frase nel file tramite $f 

12 @fclose($f); // è importante chiudere il file 

13 

14 echo ". Fatto!"; 

15 

16 }else{ 

17 echo "<br>Errore durante l'apertura del file dati_6.txt"; 

18 } 

19 ?> 

20 

21 </body></html> 


È bene sottolineare che in questo caso non ci sono controlli sulle dimensioni del file di testo 
generato. Ogni volta che lo script viene eseguito il file ‘dati_6.txt’ aumenta di dimensioni. 
Se la pagina è molto visitata a lungo andare potrebbe addirittura saturare il disco. Visto che 
questo è un semplice esercizio e non si ha alcun bisogno dei dati contenuti nel file verrà aggiunto 
un controllo che elimina il file seie sue dimensioni superano un determinato valore. Ecco una 
soluzione: 

0 <htmlxbody> 

1 

2 <? 

3 $max_file_size = 4000; // dimensione massima in byte 

4 

5 if(file_exists("dati_6.txt") && filesizeCdati_6.txt") > $max_file_size ){ 

6 echo "<brxbr><b>Vuoto il file! ha superato il limite</bxbrxbr>" ; 

7 $f = @fopen("dati_6.txt", "w"); //lo apre scrittura e lo svuota 

8 }else{ 

9 $f = Sfopen("dati_6.txt", "a"); //lo apre scrittura e appende i dati 

10 } 

11 if($ f){ 

12 echo "<brxbr>file <a href=\"datì_6.txt\">dati_6.txt</a> Aperto."; 
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13 echo "<br><br>Sto salvando i tuoi dati nel file"; 

14 

15 $frase = "visitatore di 6.php - 

16 $frase = $frase."ìl suo IP :".$REMOTE_ADDR." alle ore: ".date("d-m-Y G:i:s")." \n" 

17 

18 Sfputs($f,$frase); // scrive la frase nel file tramite $f 

19 @fclose($f); // è importante chiudere il file 

20 

21 echo ". Fatto!"; 

22 

23 }else{ 

24 echo "<br>Errore durante l'apertura del file dati_6.txt"; 

25 } 

26 ?> 

27 

28 </body></html> 


Le modifiche sono semplici, è stato aggiunto un ‘if’ che controlla la dimensione del file 
‘dati_6 . txt’ se è maggiore del valore impostato nella variabile ‘$max_f ile_size’ apre il file 
in modalità ‘w’ e quindi ne cancella il contenuto, altrimenti lo apre in modalità ‘a’. In entrambi i 
casi se il file non esiste viene creato. 

5.6 Conclusioni 

Il file System, come appena visto, permette di immagazzinare informazioni su disco dando la pos¬ 
sibilità di aggiornarle modificandole o cancellandole. Tuttavia è bene tenere presente che esistono 
tecnologie relazionali apposite per la gestione di grandi moli di dati che garantiscono maggiori 
prestazioni e una migliore gestione dello spazio su disco. Tali tecnologie sono le basi di dati alle 
quali si accede tramite un linguaggio di interrogazione standard noto come SQL^. 

Il file rimane comunque uno strumento utile, semplice e immediato, e nel caso di piccole quantità 
di dati o nel caso in cui non si abbia accesso ad un DBMjP, può essere preso in considerazione 
come alternativa alle basi di dati. 


Programmare in PHP — Copyright © 2001-2003 Gianluca Giusti — brdp @ urcanet.it 

1 Acronimo di "Structured Query Language" ovvero "linguaggio di interrogazione strutturato". 

2 Acronimo di "Data Base Management System " ovvero "Sistema di Gestione di Basi di Dati", è il software che si 
occupa di rispondere alle istruzioni SQL. 




Capitolo 


Classi e oggetti 

Uno dei grandi vantaggi del PHP è la possibilità di scrivere codice orientato agli oggetti. Le classi 
sono particolari strutture che possono contenere al loro interno variabili e funzioni dette metodi. 
Una volta definita la classe è possibile definire uno o più oggetti del tipo classe, in questo modo 
gli oggetti, le variabili in essi contenute e i metodi saranno tutti indipendenti tra loro. 

Ad esempio si immagini una classe rubrica che al suo interno contiene i metodi aggiungi), 
cercai) e rimuovi (), per manipolare i dati in archivio basterà definire un oggetto di tipo rubrica, 
tutto il necessario sarà contenuto alPinterno dell’oggetto, ovvero le procedure di inserimento, 
ricerca e cancellazione, lo sviluppatore dovrà solo fornire i parametri richiesti dai metodi. 

Spesso è comodo usare alPinterno di una classe metodi di un’altra classe, in PHP è possibile 
definire una classe come estensione di un’altea già esistente. Questo consente di risparmiare 
tempo e lavoro, inoltre rende il codice pulito e leggibile. 

Si potrebbe avere la necessità di effettuare un confronto tra due voci in rubrica. Una soluzione 
è l’aggiunta di un metodo, un’altra è estendere la classe. La scelta non è sempre scontata, in 
questo caso la strada più semplice è la scrittura di un nuovo metodo confrontai) ma spesso risulta 
conveniente creare una classe centrale che contiene i metodi fondamentali e comuni e varie classi 
satellite, estensioni di quella centrale, contenenti i metodi usati più di rado. 

ó. 1 Definizione di classi e oggetti 

Prima di approfondire il concetto di "oggetto" con degli esempi pratici è bene introdurre la sintassi 
PHP che permette di manipolarli. 

Come più volte ripetuto un oggetto è un istanza ad una classe, dunque la struttura della classe 
deve essere definita prima della dichiarazione dell’oggetto. 

La sintassi di definizione di una classe è la seguente: 

class nome_classe{ 

var variabili_comuni_alla_classe ; 

function nome_classe(parametrol="valore_di_defaultl", ...){ 


} 


function nome_metodol(parametrol, parametro2, ...){ 


} 


function nome__metodo2(parametrol, parametro2, ...){ 


} 


} 

L’istruzione ‘class’ segnala l’inizio della dichiarazione della classe, segue il nome della classe 
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e le parentesi graffe (‘ {}’) a delimitare l’inizio e la fine della struttura. 

Come prima cosa vanno dichiarate le variabili locali, ovvero le variabili che saranno a dispo¬ 
sizione di tutti i metodi e solo all’interno della struttura. Ovviamente, se non se ne ha bisogno 
possono essere omesse. 

Di seguito va definito, se necessario, il costruttore, che è un metodo particolare il quale ha lo stesso 
nome della classe e viene eseguito al momento della creazione dell’oggetto. Il costruttore non è 
obbligatorio, una classe può anche non averlo, tuttavia nella maggior parte dei casi è comodo e si 
utilizza per eseguire delle operazioni "iniziali" necessarie al funzionamento dei metodi successivi. 

Il costruttore può ricevere dei parametri che possono essere inizializzati a dei valori di default. 
Se al momento della dichiarazione dell’oggetto non vengono specificati valori diversi l’oggetto 
userà i valori stabiliti durante la dichiarazione del costruttore della classe. 

Supponendo di avere una classe chiamata ‘carrello’ il costruttore potrebbe essere qualcosa che 
inizializza le quantità a zero al momento della creazione dell’oggetto di tipo carrello: 

class carrello! 

var $q, $t_spesa, $user; 

function carrello($quantita=0, $totale_spesa=0, $utente="anonimo"){ 

$this->q = $quantita; 

$this->t_spesa = $totale_spesa; 

$this->user = $utente; 

} 

function aggiungi($quantita){ 

$this->q += $quantita; 

} 


} 


function svuota(){ 
$this->q = 0; 
$this->t_spesa = 0; 
$this->user = 


} 


Le variabili definite all’interno della classe saranno disponibili a tutti i metodi della stessa tramite 
l’uso del prefisso speciale ‘$this->’ che distingue le variabili e i metodi interni a "questa" classe. 

Una volta definita la struttura della classe è possibile istanziare uno o più oggetti di quel tipo. La 
sintassi corretta per fallo è la seguente: 

$spesa_brdp = new carrello; 

$spesa_mirko = new carrello(0, 1, "Mirko"); 


Sopra sono stati dichiarati due oggetti di tipo "carrello", nel primo caso i parametri di default sono 
stati lasciati invariati mentre nella seconda dichiarazione sono stati impostati parametri diversi da 
passare al costruttore per inizializzare il carrello. 

Una volta creati, i due oggetti, sono entità separate e indipendenti, le variabili e i metodi dell’uno 
non possono in alcun modo influenzare quelli dell’altro. Questo è uno dei grandi vantaggi che si 
ha con la programmazione orientata agli oggetti oltre all’eleganza e alla semplicità del codice. 

Non rimane che analizzare la sintassi per l’utilizzo dei metodi: 

$nome_oggetto->nome_metodo(eventuali_parametri); 




68 Classi e oggetti 

Come accennato la sintassi è intuitiva, nell’esempio sopra si potrebbe aggiungere una quantità al 
carrello virtuale tramite il metodo ‘aggiungi ($quantita) Ecco come: 

/* 

si suppone di ricevere una variabile in GET contenente 
la quantità di oggetti da inserire nel carrello. Il classico 
problema di un sito di commercio elettronico 
*7 

$q = $HTTP_GET_VARS["quantità"] ; 

// aggiungo la quantità nel carrello 
$spesa_brdp->aggìungi($q) ; 

// la raddoppio e la inserisco anche nel secondo carrello 
$q = $q * 2; // oppure $q *= 2; 

$spesa_mirko->aggiungi($q) ; 


Supponendo che il vistatole voglia svuotare il proprio carrello cliccando su una voce particolare 
un parametro viene inviato ad una pagina PHP che richiama il metodo che elimina il contenuto 
del carrello. Ad esempio: 

/* 

si suppone di ricevere una variabile in GET contenente 
il tipo di operazione da eseguire. 

*/ 

if ($HTTP_GET_VARS["da_fare"]=="svuota") { 

// vuoto entrambi i carrelli 
$spesa_brdp->svuota() ; 

$spesa_mirko->svuota( ) ; 

} 


6.2 Utilizzo di classi e oggetti 

In questo capitolo verrà trattato un esempio allo scopo di approfondire e consolidare la 
conoscenza della sintassi. 

La classe seguente gestisce un minuscolo magazzino di automobili. Ovviamente non è di alcuna 
utilità applicativa ma aiuta ad acquisire dimestichezza con questo nuovo concetto. 

o <? 

1 class automobile! 

2 

3 // Proprietà' 

4 var $archivio; 

5 

6 // costruttore della classe 

7 function automobile(){ 

8 $this->archivio = array("Audi"=>"A4", "Ford"=>"Focus, Fiesta","Fiat"=>"Stilo" 

9 "Lancia"=>"Libra","Renault"=>"Laguna, Megane"); 


10 

} 

// fine costruttore 

11 



12 

function modello($marca){ 

13 


// ritorna il modello della marca passata 

14 


return $this->archivio["$marca"]; 

15 

} 

// fine metodo modello 

16 



17 

function elenco(){ 
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18 // visualizza l'elenco completo marca - Modelli 

19 echo "<br>Elenco completo parco Auto:<br>"; 

20 foreach($this->archivio as $marca => $modello){ 

21 echo "<br>Per ".$marca." sono disponibili: ".$modello; 

22 } 

23 } // fine metodo elenco 

24 

25 } // Fine classe automobile 

26 

27 ?> 

28 

29 <html> 

20 <body> 

31 

32 <? 

33 // creo l'oggetto di tipo automobile! 

34 $concessionario = new automobile; 

35 

36 if($HTTP_GET_VARS["casa"] != "0"){ 

37 echo "Ecco ì modelli <u>".$HTTP_GET_VARS["casa"]."</u> disponibili: 

38 <b>".$concessionario->modello($HTTP_GET_VARS["casa"])."</b>"; 

39 }else{ 

40 $concessionario->elenco ( ); 

41 } 

42 

43 ?> 

44 

45 <br><brxbr> 

46 

47 <form method="get" action="<?=$PHP_SELF?>"> 

48 Seleziona la marca per avere i modelli disponibili: 

49 <select name="casa"> 

50 <option value="0">Elenco completo 

51 <option value="Audi">Audi 

52 <option value="Ford">Ford 

53 <option value="Fiat">Fiat 

54 <option value="Lancia">Lancia 

55 <option value="Renault">Renault 

56 </select> 

57 

58 <ìnput type="submit" value="Trova modelli!"> 

59 </form> 

60 

61 </body> 

62 </html> 


Dalla riga 1 alla 25 viene definita la nuova classe chiamata "automobile", che contiene una 
variabile ‘$archivio’, il costruttore ‘automobile’ e due metodi ‘modello’ ed ‘elenco’. 

Come detto più volte, una classe al suo interno può contenere variabili e funzioni oltre a tutte le 
strutture messe a disposizione dal linguaggio. 

Nell’esempio specifico il costruttore ‘automobile’ non fa altro che riempire un array associa¬ 
tivo assegnato alla variabile ‘$archivio’, tale variabile contiene i modelli delle varie marche 
disponibili nel magazzino. 

Dopo il costruttore vengono definiti due semplici metodi: il primo, ‘modello ($marca) ’, for¬ 
nisce i modelli della marca passata come parametro, leggendoli dall’array ‘$archivio’ e 
restituendoli tramite il comando ‘return’, proprio come in una semplice funzione. Tutto questo 
viene fatto nella riga 14. Il secondo, ‘elenco’, non restituisce alcun valore e non richiede 
parametri al momento della chiamata ma visualizza a schermo l’intero magazzino tramite un 
ciclo ‘foreach’ nelle righe 20, 21 e 22. 
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A questo punto la dichiarazione della classe è completa, non resta che istanziare uno o più oggetti 
di tipo "automobile" per poter sfruttare i metodi definiti. L’esempio continua proprio con l’utilizzo 
di un oggetto. 

Alla riga 34 viene dichiarato l’oggetto ‘$concessionario’ di tipo ‘automobile’ tramite 
l’istruzione: 

$concessionario = new automobile; 


Al momento della dichiarazione viene eseguito il costruttore che, in questo caso, inizializza 
l’array ‘$archivio’ (contenuto nel nuovo oggetto). Da questo momento sono disponibili tutti 
i metodi dell’oggetto ‘$concessionario\ 

Nel caso specifico dell’esempio alle righe 38 e 40 vengono richiamati i due metodi definiti 
in precedenza. Tali metodi sono stati costruiti in modo diverso: il primo restituisce un valore 
tramite l’istruzione ‘return’ mentre il secondo, ‘elenco ()’, visualizza sullo schermo i dati 
senza ritornare alcun valore. Questa differenza nella definizione comporta un utilizzo diverso dei 
metodi. 

Nel dettaglio, il metodo ‘modello ($marca) ’ può essere associato ad una variabile o concatenato 
ad una stringa quindi può essere manipolato come una variabile. Il metodo ‘elenco ( ) ’ invece, 
può essere usato solo in un modo, per visualizzare l’elenco di tutte le marche e modelli sullo 
schermo. 

Ecco gli utilizzi dei metodi nel dettaglio: 

$concessionario = new automobile; 

// Concateno in una stringa 

echo "Ecco i modelli <u>Audi</u> disponìbili: 

<b>".$concessionario->modello("Audi")."</b>"; 

// Oppure assegno ad una variabile 
$modelli = $concessionario->modello("Ford"); 

// Mentre il metodo elenco può essere usato solo così: 

$concessionario->elenco(); 

Come detto gli oggetti sono entità separate, dunque è possibile istanziare più oggetti della stessa 
classe come: 

$concessionario = new automobile; 

$auto = new automobile; 

// Concateno in una stringa 

echo "Ecco i modelli <u>Audi</u> disponibili: 

<b>".$auto->modello("Audi")."</b>"; 

// Oppure assegno ad una variabile 
$modelli = $concessionario->modello("Ford"); 

// Mentre il metodo elenco può essere usato solo così: 

$concessionario->elenco( ) ; 

// Mentre il metodo elenco può essere usato solo così: 

$auto->elenco(); 


L’esempio continua con un semplice modulo HTML che spedice una variabile contenente la 
marca selezionata a se stesso (tramite la variabile predefinita ‘$PHP_SELF’). Tale variabile viene 
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passata al metodo che restituisce i modelli disponibili per la marca scelta. Se il valore della marca 
è 0 viene visualizzato l’elenco completo tramite l’utilizzo del secondo metodo. 

Il funzionamento dell’esempio può essere verificato a questo indirizzo: <http://www.urcanet.it/brdp/ 
php_man ual/ esempi 1 eap_ 7/l.php> 


6.3 Esempi applicativi 

Una volta chiarita la sintassi si può passare a scrivere una prima classe da collezionare. Nella 
programmazione di tutti i giorni ci sono operazioni che si ripetono e che quindi possono risultare 
noiose. Un classico esempio è la gestione dei formati delle date. Il PHP mette a disposizione nu¬ 
merose funzioni di gestione delle date, esse sono versatili e accettano numerose opzioni. Potrebbe 
essere vantaggioso scrivere una classe che formatta la data secondo le proprie necessità, ovvero 
nei formati che si utilizzano più frequentemente. Ecco un esempio: 

1 <? 

2 

3 // -DATA e ORA- 

4 /* Formatta la data in vari formati. 

5 è possibile aggiungere nuovi formati accodando 

6 righe alla "switch" finale 

7 * / 

8 

9 class data_ora{ 

10 

11 // Proprietà' 

12 var $mesi, $week; 

13 var Sore, $minuti, $secondì; 

14 var $gs, $mese, $gmese. Sanno; 

15 

16 // costruttore 

17 function data_ora(){ 

18 // Salva in diverse variabili la data nei vari formati: 

19 // definisce l'array per i mesi e per i giorni della settimana. 

20 

21 $this->week = array(0=>"Domenica","Lunedì","Martedì ","Mercoledì", 

22 "Giovedì","Venerdì","Sabato" ); 

23 

24 $this->mesi = array ("1"=>"Gennaio", "Febbraio", "Marzo", "Aprile", 

25 "Maggio", "Giugno", "Luglio", "Agosto", 


26 


II 

Settembre", "Ottobre", "Novembre" 

, "Dicembre" 

27 

28 

$this->gs 

= date("w") ; 

// 

giorno della settimana 0 è 

domenica 

29 

$this->m = 

date("n"); 

// 

mese numerico 9 non 09 


30 

$this->mm 

= date("m") ; 

// 

mese stringa 09 non 9 


31 

$this->g = 

date ( "j"); 

// 

giorno del mese numerico 9 

non 0 9 

32 

$this->gg 

= date("d"); 

// 

giorno del mese stringa 09 

non 9 

33 

$this->anno = date("Y" 

) ; // 

anno ovviamente numerico 


34 

35 

$this->o = 

date("H"); 

// 

ore con lo zero avanti in 

formato 24 

36 

$this->mi 

= date("ì"); 

// 

minuti con lo zero esempio 

: 09 

37 

$this->s = 

date ("s"); 

// 

secondi con lo zero 09 


38 

39 

40 

41 

} // fine costruttore 





42 function formatta($tipo_data){ 

43 

44 switch ($tipo_data) { 

45 case 1: 

46 return $this->g."-".$this->m..$this->anno; 

47 break; 
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48 case 2: 

49 return $this->anno.".$this->m."-".$this->g; 

50 break; 

51 case 3: 

52 return $this->m..$this->g..$this->anno; 

53 break; 

54 case 4 : 

55 return $this->week[$this->gs] . " " .$this->g..$this->m. 

".$this->anno; 

56 break; 

57 case 5: 

58 return $this->week[$this->gs] ." " .$this->g..$this->mesi[$this->m] . "- 
".$this->anno; 

59 break; 

60 case 6: 

61 return $this->week[$this->gs] ." " .$this->gg.".$this->mm. 

".$this->anno; 

62 break; 

63 case 7 : 

64 return $this->week[$this->gs] ." " . $this->gg.".$this->mesi[$this->m] . 

".$this->anno; 

65 break; 

66 case 8: 

67 return $this->week[$this->gs]." ".$this->g..$this->mesi[$this->m]."- 

".$this->anno." 

68 ore: ".$this->o.":".$this->mi; 

69 break; 

70 } 

71 

72 } // fine metodo formattazione 

73 

74 } 

75 

76 ?> 

77 

78 

79 <html> 

80 <body> 

81 

82 <? 

83 

84 $adesso = new data_ora; 

85 

86 for ($i = 1; $i <= 8; $i++){ 

87 echo "<br>La data odierna formattata con <b>".$i."</b> è: 

".$adesso->formatta($i); 

88 } 

89 ?> 

90 

91 

92 </body> 

93 </html> 

Analizzando la classe nel dettaglio si vede che è composta da varie proprietà (le variabili), il 
costruttore ed un metodo. Il costruttore inizializza gli array contenenti i nomi dei giorni della 
settimana e dei mesi dell’anno, inoltre inizializza tutte le altre variabili con dei valori riferiti alla 
data "odierna" tramite la funzione predefinita "date () ’. Tali variabili serviranno in seguito per 
estrarre i vali formati di data. 

Il metodo ‘formatta ($tipo_data) ’ in base al parametro passato restituisce una stringa conte¬ 
nente la data formattata in un particolare modo. Il parametro deve essere un intero nell’esempio 
compreso tra 1 e 8 ma nulla vieta di estendere l’elenco. 
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Il funzionamento è semplice, tramite una struttura ‘switch’ (trattata nella sezione 12.5.41) il 
metodo concatena le variabili inizializzate dal costruttore in modo da generare una stringa 
particolare. 

Per verificare il funzionamento della classe ed elencare tutti i formati delle date disponibili, l’e¬ 
sempio continua con la creazione di un oggetto ‘$adesso’ di tipo ‘data_ora’ e con un sem¬ 
plice ciclo ‘for’ che richiama il metodo ‘$adesso->formatta ($i) ’ passandogli i valori interi 
compresi tra 1 e 8 come vuole la dichiarazione della classe. 

Il risultato dello script sarà simile a: 


La data odierna formattata con 1 è: 
La data odierna formattata con 2 è: 
La data odierna formattata con 3 è: 
La data odierna formattata con 4 è: 
La data odierna formattata con 5 è: 
La data odierna formattata con 6 è: 
La data odierna formattata con 7 è: 
La data odierna formattata con 8 è: 


19-12-2002 

2002-12-19 

12-19-2002 

Giovedì 19-12-2002 

Giovedì 19-Dicembre-2002 

Giovedì 19-12-2002 

Giovedì 19-Dicembre-2002 

Giovedì 19-Dicembre-2002 ore: 10:40 


Il metodo restituisce la data tramite l’istruzione ‘return’, quindi la chiamata al metodo può 
essere trattata come una variabile, infatti, nell’esempio viene concatenata ad una stringa (riga 87) 
per essere visualizzata sullo schermo. 

Al lettore il compito di comprendere il comportamento del metodo nel caso in cui venga fornito 
un paramentro non intero oppure non compreso nell’intervallo di definizione della struttura di 

‘switch’. 

La prima parte di codice fino alla riga 77 potrebbe essere salvata in un file per diventare una 
sorta di libreria di seguito chiamata ‘brdp_l±b. php’ dove verranno raccolte tutte le classi di uso 
frequente. Una volta creato il file basterà includerlo all’inizio delle nuove pagine PHP per avere 
tutte le classi a disposizione. Dunque si potrà ottenere lo stesso risultato dell’esempio precedente 
creando il file ‘brdp_lib .php’ e modificando l’esempio in questo modo: 

<? include("brdp_lib.php"); ?> 

<html> 

<body> 

<? 

$adesso = new data_ora; 
for ($i = 1; $i <= 8; $ì++){ 

echo "<br>La data odierna formattata con <b>".$i."</b> è: 

".$adesso->formatta($i) ; 

} 

?> 

</body> 

</html> 


In questo modo oltre ad essere più chiara la struttura è anche più semplice aggiornare le fun¬ 
zionalità delle classi. Se ad esempio la classe viene già usata in dieci pagine differenti e si ha 
la necessità di aggiungere un nuovo tipo di formattazione oppure modificarne uno già esistente, 
basterà modificare un unico file per rendere le modifiche disponibili in tutte e dieci le pagine che 
utilizzano oggetti di quel tipo. Al contrario si dovrebbe ripetere la stessa modifica in dieci pagine 
diverse. 

Anche in questo caso l’esempio è raggiungibile all’indirizzo: <http://www.urcanet.it'brdp/php_manual/ 
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esempi, ' ;ap_ 7, ' 2 .plip > 

La classe appena vista potrebbe formattare anche date diverse da quella odierna, ad esempio 
ricevendo un parametro passato al costruttore e impostato come default alla data attuale, in questo 
modo, se specificato, al momento della dichiarazione dell’oggetto verrà formattata una data par¬ 
ticolare, altrimenti verrà presa come data quella odierna. Questa semplice modifica viene lasciata 
al lettore come esercizio. 

Nei capitoli seguenti verranno studiate altre classi ed inserite nella libreria ‘brdp_lib .php’ 
appena creata. 
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Capitolo 

Il PHP e le base di dati 


Una caratteristica del PHP è la capacità di gestire direttamente i principali serventi di base di dati 
tramite connessioni dirette senza l’utilizzo di strati intermedi quali ODBC (anche se gestiti per¬ 
fettamente) o JDBC; una volta installato l’interprete in modo corretto, si è in grado di connettersi 
a qualunque base di datPl Si va da ORACLE a MSSQLServer a DB2 per arrivare ai più diffusi e 
leggeri MySQL e PostgreSQL. 

La scelta di MySQL per gli esempi della guida non è casuale bensì obbligata visto il successo 
avuto negli ultimi anni da questo DBMSPche vanta una leggerezza e grandi prestazioni anche se 
non dispone di tutte le caratteristiche e funzionalità dei concorrenti di fascia superiore. Inoltre è 
distribuito liberamente in Internet ed è facile da installare e configurare. 

Per lo sviluppo di progetti di medie dimensioni, dunque, MySQL risulta un’ottima scelta; per 
questo motivo i siti Internet che lo utilizzano aumentano a vista d’occhio incoraggiandone lo 
sviluppo. 

Tutto ciò che verrà trattato di seguito con applicazioni pratiche riguarderà MySQL. 

7.1 Gestione centralizzata della base di dati 

Il PHP è in grado di gestire le base di dati mediante un linguaggio d’interrogazione strutturato 
chiamato SQL^ che tramite una sintassi standard permette di effettuare tutte le operazioni nec¬ 
essarie sui dati contenuti in archivio, inserimenti, modifiche, cancellazioni, selezione e quanto 
altro. Verrà data per scontata una conoscenza di base dell’SQL e si procederà con la trattazione 
di problematiche legate al suo utilizzo tramite il PHP. 

Le base di dati sono strutture progettate e realizzate con lo scopo di immagazzinare e gestire 
grandi moli di dati. Mediante particolari algoritmi di ricerca vengono forniti i dati richiesti in 
breve tempo senza doversi preoccupare di come essi vengono scritti e letti sul disco, in altre parole 
si può pensare alla base di dati come ad un magazzino al quale ci si rivolge per depositare e ritirare 
del materiale senza doversi preoccupare di dove e come esso viene archiviato. Nel momento del 
bisogno basterà solo richiedere il materiale al "magazziniere" che saprà dove e come prendere i 
dati e come fornirceli in maniera leggibile. 

Una volta creata la base di dati e attivate le politiche di accesso ciò di cui si necessita per operare 
sui dati è: 

• Indirizzo IP . L’indirizzo IP dell’elaboratore che ospita il DBMS MySQL; 

• Nome della base di dati. Ogni base di dati viene identificata mediante un nome; 

• Username. Il nome dell’utente abilitato alla manipolazione dei dati contenuti nella base di 
dati; 

• Password. La parola di accesso alla base di dati. 

Appare chiaro che questi dati sono importanti e vanno tenuti segreti ma è altrettanto chiaro che 
potrebbero cambiare per motivi di sicurezza o per necessità di manutenzione; tale aspetto non va 
sottovalutato durante la progettazione e la scrittura del codice. Un consiglio è quello di concen¬ 
trare in un unico file tutti i parametri necessari alla connessione alla base di dati, tale file verrà 
poi incluso all’inizio di ogni pagina dalla quale si voglia effettuare una connessione al database. 

1 L’elenco delle base di dati gestite dal PHP è riportato nella sezione [L2l 

2 Acronimo di DataBase Management System ovvero il sistema di gestione delle base di dati. 

3 Acronimo di Structured Query Lenguage. 
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In una situazione estrema potrebbe cambiare addirittura il tipo di DBMS utilizzato, in questo caso 
se si rispettano gli standard e si disegna il codice in modo intelligente con poche modifiche si può 
continuare ad utilizzare la stessa applicazione PHP pur cambiando il tipo di base di dati in gioco. 
Questo tuttavia è un esempio estremo e se non si hanno necessità particolarP di progettazione 
conviene disegnare l’applicazione intorno alla base di dati in modo da sfruttare al massimo le 
prestazioni del DBMS. 

Un buon metodo di procedere è quello di inserire uno strato tra le funzioni del PHP e la nostra 
programmazione, ad esempio una classe che gestisce l’interazione con la base di dati, in questo 
modo il codice è meno rigido e permette di apportare modifiche in modo meno laborioso. 

Un esempio pratico. Ue fasi principali di una interrogazione ad una base di dati sono le seguenti: 

Connessione alla base di dati 

interrogazione 1 
interrogazione 2 

interrogazione n 

Disconnessione dalla base di dati 


Osserviamo nel dettaglio la gestione della connessione ad una base dati nel caso di MySQL: 

o <? 

1 $host = "192.168.1.1"; 

2 $user = "utente_autorizzato"; 

3 $password = "password_utente"; 

4 

5 $connessione = mysql_connect($host,$user,$password); 

6 

7 mysql_close(Sconnessione); 

8 ?> 


Mentre nel caso di PostgreSQL: 

o <? 

1 Sport = 5432; # numero di porta in cui ascolta PostgreSQL 

2 Shost = "192.168.1.1"; 

3 Suser = "utente_autorizzato"; 

4 Spassword = "password_utente"; 

5 Sdbname = "nome_base_datì"; 

6 $authtype="password" # tipo di autenticazione 

7 

8 Sconnessione = pg_Connect("Shost Sport Sdbname Suser Spassword Sauthtype"); 

9 

10 pg_Close(Sconnessione); 

11 ?> 


Le differenze sono lampanti, PostgreSQL richiede molti parametri in più, inoltre effettua una 
connessione direttamente ad una particolare base di dati mentre in MySQL il nome del database 
va specificato al momento dell’esecuzione della query SQL. 

Si pensi ad un sito moderno con molti contenuti, ad esempio un portale che in ogni pagina es¬ 
egue almeno una connessione per estrarre i dati da visualizzare dalla base di dati; è impensabile 

4 È il caso di applicazioni Web generiche che devono essere personalizzabili secondo le necessità dettate da strutture 
già esistenti. Ad esempio un gestore di banner pubblicitari deve appoggiarsi su strutture già esistenti come quelle di un 
portale e spesso viene integrato nella base di dati a disposizione. In questo caso il prodotto deve gestire i diversi DBMS 
altrimenti resterebbe tagliato fuori da una o più fette di mercato. 
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scrivere codice come quello visto sopra in ogni pagina del sito, se solo cambiasse la password si 
dovrebbero modificare tutte le pagine interessate. 

A questo punto dovrebbe essere chiaro che l’ideale è la realizzazione di una classe da includere al¬ 
l’inizio di ogni pagina PHP che necessita di una connessione alla base di dati, in cui implementare 
tutte le funzionalità necessarie. 

I problemi precedentemente posti sono risolti. Se dovessero cambiare i parametri basterebbe mod¬ 
ificare un solo file, quello contenente la dichiarazione della classe, impostando i nuovi valori. Se 
dovesse cambiare il DBMS basterebbe riscrivere il codice della classe mantenendo invariati gli 
standard di definizione e funzionamento dei metodi, in questo modo tutti gli oggetti continuereb¬ 
bero a funzionare. Non sempre questo passaggio è possibile, tutto dipende da come viene scritto 
il codice. 

Nelle pagine seguenti verrà implementata una classe utile per la gestione di base di dati MySQL 
dando per scontata la procedura di creazione della base di dati utilizzata negli esempi che 
seguiranno la parte teorica. 

Per gli esempi pratici della guida verrà utilizzata una piccola e semplice base di dati dal nome 
brdp_esempio _1 il cui script di creazione è reperibile al seguente indirizzo in formato' .tgz’: 
<http://www.urcanet.it/brdp/php_manual/esempi/cap_8/iql_l.tgz> O se si preferisce il formato ‘. zip’: <http:/ 
/www.urcanet.it'brdp/php_manual/isempi/:ap_8/sql_l.zip> 


12 La classe database 


In questa sezione verrà trattata la classe ‘database’, distribuita sotto licenza GNU/GPL, che 
gestisce la connessione e l’interazione con le base di dati, in questo caso di tipo MySQL ma 
un utile esercizio potrebbe essere la riscrittura della classe per un altro DBMS, ad esempio 
PostgreS QL. 

La versione completa della classe può essere scaricata nei formati ‘. tgz’ e ‘ . zip’ dai seguenti 
indirizzi: <http://www.urcanet.it'brdp/php_manual/isempi/:ap_8/brdp_db_php.tgz> e <http://www.urcanet.it'brdp/ 
php_man ual, 'esempi, 'cap_8/ brdp_db. zip > 

Ecco un estratto del codice della classe. 

1 <? 

2 

3 class database { 

4 var $db; 

5 

6 

7 /* 

8 @@@@@@@@@@@@@@@@@@@@@@@@@@1 COSTRUTTORE | @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@ 

9 assegna i valori alla variabile $db per poi aprire la connessione 

10 mediante il metodo connetti)); se al momento della dich. dell'oggetto non 

11 vengono passati valori specifici vengono assegnati i valori di default 

12 @@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@0 

13 */ 

14 function database($USER="brdp", $PASSWORD="brdp", $DB="brdp_esempio_l", 

$HOST="localhost" ){ 

15 $this->db["user"] = $USER; 

16 $this->db["password"] = $PASSWORD; 

17 $this->db["db"] = $DB; 

18 $this->db["host"] = $HOST; 

19 } 

20 
21 

22 /* 

23 #############################| METODO |################################### 
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24 Apre la connessione al DB secondo i valori impostati dal costruttore. 

25 Se la connessione fallisce visualizza un messaggio di errore. 

26 La parte HTML può essere personalizzata secondo le necessità 

27 ############################################################################ 

28 */ 

29 function connetti (){ 

30 

31 

32 

33 

34 

35 

36 ?> 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 <? 

59 

60 

61 } 

62 

63 

64 /* 

65 ############################# | METODO |################################### 

66 Chiude la connessione al DB aperta dal metodo connetti(); 

67 

68 

69 ############################################################################ 

70 */ 

71 function disconnetti (){ 

72 @mysql_close($this->db[connessione]); 

73 } 

74 

75 

76 /* 

77 #############################| METODO ################################### 

78 Esegue la query ricevuta come parametro alla chiamata. 

79 Se la query e la sua esecuzione vanno a buon fine ritorna true o il 

80 risultato (esempio in una select) altrimenti torna false 

81 ############################################################################ 
82 */ 

83 function esegui($query) { 

84 $this->db["risultato"] = @mysql_db_query($this->db[db] , $query, 

$this->db[connessione] ) ; 

return $this->db[risultato] ; 


$this->db["connessione"] = @mysql_connect($this->db[host], 

$this->db[user],$this->db[password]) ; 
if ($this->db[connessione] ) { 
return $this->db[connessione] ; 

}else{ 

# La tabella seguente contiene il messaggio di errore di 

# connessione, può essere personalizzato secondo le necessità. 

<br> 

<table align="center" width="500" cellspacing="0" cellpadding="4" 
border="1"> 

<tr bgcolor="#e2e2e2"> 

<td> 

<font color="#000000" face="helvetica,verdana" size="5"> 
<b>PROBLEMI DI CONNESSIONE</b> 

</font> 

</td> 

</tr> 

<tr> 

<td> 

<font size="2" color="#4F4F4F" face="Helvetica, Verdana"> 

I nostri server sono, momentaneamente, <b>sovraccarichi</b> 
e NON possono stabilire una connessione. Vi invitiamo a 
riprovare più tardi. Se il problema persiste, per favore, 
segnalatelo al<bxi> 

<a href="maìlto : webmastert@del_sito. it ">webmaster</ax/ix/b>. 
</font> 

</td> 

</tr> 

</table> 

exit ; 

} 
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86 } 

87 

88 

89 /* 

90 #############################1 METODO |################################### 

91 Esegue la query ricevuta come parametro alla chiamata formatta il 

92 risultato in una select html. Va passata la query, il campo da visualizz. 

93 il valore da inserire in value il valore del selected e il tipo di output 

94 ############################################################################ 

95 */ 

96 function query2select($query, $nome, $valore, $default, $metodo){ 

97 if($this->esegui($query)){ 

98 for($i=0; $i<$this->righe(); $i++){ 

99 $sel=""; 

100 if ($default == $this->leggi($i,$valore)) 

101 $sel="selected"; 

102 

103 $ris = $ris."<option value=\"".$this->leggi ($i,$valore) .".$sel.">"; 

104 $ris = $ris.$this->leggi($i,$nome)."</option>\n"; 

105 } 

106 

107 if($metodo){ 

108 echo $ris; 

109 return true; 

110 }else{ 

111 return $ris; 

112 } 

113 }else{ 

114 return false; 

115 } 

116 } 

117 

118 

119 /* 

120 #############################1 METODO |################################### 

121 Nel caso di una query di insert torna il valore dell'ID se auto_increment 

122 assegnato all'ultimo valore inserito nel DB da questa connessione. 

123 NON l'ultimo in assoluto! l'ultimo inserito tramite questa connessione! 

124 ############################################################################ 

125 */ 

126 function getlast_id(){ 

127 return @mysql_insert_id($this->db[connessione]) ; 

128 } 

129 

130 

131 /* 

132 #############################1 METODO |################################### 

133 Ritorna il valore del campo $nome_campo della riga $numero_riga 

134 restituito da una query tipo select 

135 

136 ############################################################################ 

137 */ 

138 function leggi($numero_riga,$nome_campo){ 

139 return @mysql_result($this->db[risultato],$numero_riga,$nome_campo); 

140 } 

141 

142 

143 /* 

144 #############################| METODO |################################### 

145 Ritorna il numero di righe restituito dall'ultima query di tipo select 

146 

147 

148 ############################################################################ 

149 */ 
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150 function righe (){ 

151 $this->db["righe"] = @mysql_num_rows($this->db[risultato]); 

152 return $this->db[righe]; 

153 } 

154 } 

155 

156 ?> 


Si inizi con l’analizzare la struttura della classe. Il costruttore ammette quattro parametri, ovvero i 
parametri necessari alla connessione con la base di dati; essi possono essere scritti in modo diretto 
nella classe o impostati in altri file di configurazione da includere prima di essa. Nei nostri esempi 
inseriremo i parametri nella classe e la includeremo come libreria al principio di ogni script che 
necessita di interfacciarsi con una base di dati. 

Dal modo in cui vengono passati i parametri al costruttore si capisce che la classe gestirà una 
base di dati di default ma sarà in grado di interrogarne anche altre tramite oggetti dichiarati con 
parametri diversi. Per comprendere meglio il concetto ecco un esempio: 

<? 

include("brdp_db.php"); 

# Oggetto per la gestione della Base dati dì default 

$db_l = new database; 

# Oggetto per la gestione di una Base dati occasionale o diversa 

$db_2 = new database("utente_xxx", "passwd", "DB_di_prova", "localhost"); 


I due oggetti creati lavoreranno in modo analogo con gli stessi metodi ma su due base di dati 
diverse, tuttavia conviene dichiarare sempre i parametri in modo centralizzato, magari in un ar- 
ray prima della classe, in questo modo sarà sempre semplice modificare i valori necessari alla 
connessione. 

Una volta creato l’oggetto bisogna connettersi al DBMS; va sottolineato che l’accesso alla base 
di dati è di tipo concorrenziale e che c’è un limite alle connessioni che possono essere mantenute 
aperte contemporaneamente dal servente, quindi è bene chiudere sempre la connessione e prima 
possibile. 

<? 

include("brdp_db.php"); 

# Creazione oggetto 
$db = new database; 

# Apertura della connessione 
$db->connetti (); 

# Chiusura della connessione 
$db->disconnetti ( ); 

?> 


Come è facile intuire, con il metodo ‘connetti () ’ viene aperta la connessione che può essere 
chiusa tramite il metodo ‘ disconnetti ( ) ’. Se il DBMS è in ascolto e i parametri per la connes¬ 
sione, nonché la base di dati, sono corretti l’esempio dovrebbe mostrare una schermata bianca, in 
caso contrario una pagina simile a quella in fi aura ITTI 
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Figura [7j] Il messaggio può essere personalizzato nella dichiarazione della classe. 
Notare che i messaggi di errori dell'interprete non compaiono. 



Dunque una volta connessi è possibile interrogare la base di dati mediante la sintassi SQL e 
il metodo ‘esegui ($query_sql) ’ che ritorna un valore falso se ci sono problemi durante 
l’esecuzione della query. 

In particolare il PHP restituisce il risultato di operazioni di tipo SELECT in array associativi a 
due dimensioni strutturati con il nome del campo e il numero di righe partendo da 0. In pratica, 
una query di questo genere: ‘SELECT nome, cognome FROM BRDP_TB_UTENTI LIMIT 0, 
3’ eseguita sulla base di dati di prova brdp_esempio_l restituisce questo risultato: 


+- 


- + - 


- + 

1 

nome 

1 

cognome 

i 

+- 


- + - 


- + 

1 

Gianluca 

1 

Giusti 

i 

1 

Mirko 

1 

Simeoni 

i 

1 

Fabio 

1 

Ferri 

i 

+- 


- + - 


- + 


Viene estratto sotto forma di array associativo di dimensione 2x3 i cui valori possono essere 
"letti" tramite il metodo ‘leggi ($numero_riga, $nome_campo) Per conoscere il numero di 
righe restituite dalla query basta utilizzare il metodo ‘righe () ’. Ricapitolando la procedura è la 
seguente: 

1 <? 

2 include("brdp_db.php"); 

3 

4 # Creazione oggetto 

5 $db = new database; 

6 

7 # Apertura della connessione 

8 $db->connetti(); 

9 

10 # Preaparazione della Query 

11 $query_sql = "SELECT nome, cognome FROM BRDP_TB_UTENTI LIMIT 0, 3"; 

12 

13 if($db->esegui($query_sql)){ 

14 for($i=0; $i<$db->rìghe(); $ì++ ){ 

15 echo "<br>".$i.") Nome: ".$db->leggi($i,"nome"); 

16 } 

17 

18 


} 
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19 # Chiusura della connessione 

20 $db->disconnettì ( ); 

21 ?> 

Il risultato è simile a: 

0) Nome: Gianluca 

1) Nome: Mirko 

2) Nome: Fabio 


Va notato che lo script non mostra il cognome, è compito del lettore completare l’esempio. 

Una volta creato l’oggetto e stabilita la connessione viene impostata la query da eseguire sulla 
base di dati, tramite un controllo ‘if ’ ne viene verificata l’esecuzione, se non è falsa allora cicla i 
valori estratti tramite un ciclo ‘for’. Per la precisione andrebbe inserito un ‘else’ alla riga 17 per 
segnalare eventuali errori nell’esecuzione, anche questo ultimo ritocco è lasciato come esercizio 
al lettore. 

Va sottolineato che le righe dell’array partono con indice 0. 

Per concludere, la classe comprende altri due metodi ‘query2select’ e ‘getlast_id’ che 
verranno trattati in seguito tramite degli esempi. Il primo esegue una query e formatta il risultato 
nel contenuto di una SELECT HTML mentre il secondo restituisce il valore dell’ID generato 
(in modalità "auto_increment") nell’ultimo inserimento effettuato tramite la connessione in uso 
dall’oggetto. 

7.3 Primo esempio di utilizzo della classe database 

Per gli esempi di utilizzo della classe verrà utilizzata la base di dati chiamata brdp_esempio_1 che 
è possibile riprodurre fedelmente tramite lo script reperibile all’indirizzo riportato nella sezione 

im 

La base di dati è molto semplice ed è composta da due tabelle strutturate come di seguito: 

BRDP_TB_UTENT I 

+-+-+-+-+-+-+ 

I Field | Type | Nuli | Key | Default | Extra | 

+-+-+-+-+-+-+ 


id_utente 

1 int (11) | 

| PRI | NULL 

1 auto_increment 

nome 

| varchar(70) | 

1 1 


cognome 

varchar(70) | 

1 1 

1 

email 

| varchar(lOO) | 

1 1 


attivo 

1 int(11) 1 

1 1 0 



+-+-+-+-+-+-+ 


BRDP_TB_AGENDA 








+ ' 


- + - 


- +- 

- + - 


- + - 


- +- 

- + 


Field 

1 

Type 

| Nuli 

1 

Key 

1 

Default 

1 Extra 

1 

+ - 


- + - 


- +- 

- + - 


- + - 


- +- 

- + 

1 

id_agenda 

1 

int(11) 

1 

1 

PRI 

1 

NULL 

auto_increment 

1 

1 

id_utente 


int (11) 

1 

1 


1 

0 

1 

! 

1 

Nome 


varchar (70) 

1 

1 


1 


1 

1 

1 

Cognome 

1 

varchar(70) 

1 

1 


1 



1 

1 

email 

1 

varchar(100) 

1 

1 


1 


1 

1 

1 

telefono 

1 

varchar(20) 

1 

1 


1 


1 

1 

1 

fax 

1 

varchar(20) 

1 

1 


1 


1 

1 

+ - 


- + " 


- +- 

- + - 


- + - 


" +- 

" + 
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La prima BRDP_TB_UTENTI contiene i dati relativi a degli utenti fittizi che potrebbero avere a 
disposizione la possibilità di gestire una loro rubrica, mentre BRDP_TB_AGENDA contiene 
i contatti degli utenti relazionati tramite il valore BRDP_TB_AGENDA.id_utente all’utenza 
BRDP_TB_UTENTl.id_utente . La struttura è molto semplice e serve solo come appoggio per 
gli script di esempio inquanto la complessità delle query in gioco non cambia il concetto. 

Come primo passo nel file ‘index. php’ raggiungibile a questo indirizzo: <http:/.'www.urcanet.ii'brdp/ 
php_manual/ssempi,':ap_8,'index.php > viene eseguita una semplice query che restituisce tutti gli utenti 
con campo ‘attivo = 1’. Spesso si preferisce non rimuovere fisicamente, dati non sensibili, 
dalla base di dati ma eliminarli logicamente ovvero tramite un campo convenzionalmente im¬ 
postato a zero. In questo caso il campo che discrimina 1’esistenza o meno dell’utente è il campo 
"attivo", se contiene valore pari a 0 l’utente non è attivo, se è 1 allora va visualizzato in elenco. 

di seguito il codice del primo esempio: 

1 <? 

2 # Includo la classe per la gestione della base dì dati 

3 include("brdp_db.php"); 

4 

5 $db = new database; 

6 $db->connetti(); 

7 $sql = "SELECT * from BRDP_TB_UTENTI where attivo=l"; 

8 ?> 

9 

10 <html> 

11 <head> 

12 <title>Primo esempio di connessione alla base di dati</title> 

13 </head> 

14 <body> 

15 

16 <br> 

17 [ 

18 <a href="../../">HOME</a> - 

19 <a href="../">ESEMPI</a> 

20 ] 

21 

22 <brxbr> 

23 Esempio dì <b>interrogazione di base di dati</b>. 

24 <brxbr> 

25 

26 Come prima cosa viene effettuata una semplice SELECT dalla 

27 tabella <b>BRDP_TB_UTENTI</b> selezionando solo gli utenti attivi. 

28 La Query da eseguire è la seguente: 

29 

30 <brxbr> 

31 <ix?=$sql?X/i> 

32 <brxbr> 

33 

34 Questo il risultato della query: 

35 <brxbr> 

36 

37 <table> 

38 <? 

39 # Eseguo la query contenuta in $sql 

40 if($db->esegui($sql)){ 

41 if($db->righe()>0){ 

42 for($ì=0; $ì<$db->righe(); $i++){ 

43 $ j=$i+l; 

44 echo "<trxtd>" . $ j . " ) " . $db->leggi ($i, "nome" ) . "</td>"; 

45 echo "<tdxa href=\"dettagli .php?utente=" ; 

46 echo $db->leggi($i,"id_utente")."\">Dettagli utente</ax/td>"; 

47 echo "<tdxa href=\"agenda.php?utente=".$db->leggì($i,"id_utente"); 

48 echo "&nome=".$db->leggi($i,"nome"); 

49 echo "\">Agenda utente</a></tdx/tr>" ; 
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50 } 

51 }else{ 

52 echo "<tr><td>Nessun utente attivo in archivio</tdx/tr>"; 

53 } 

54 }else{ 

55 echo "<tr><td>Errore di interrogazione.</tdx/tr>"; 

56 } 

57 ?> 

58 </table> 

59 

60 </body> 

61 </html> 

62 

63 <? 

64 # chiusura della connessione alla base dati è importante! 

65 $db->disconnetti(); 

66 ?> 

Come prima cosa alla riga 3 viene inclusa la classe di gestione della base di dati, da tale riga in 
poi sarà possibile istanziare oggetti di tipo ‘database’ ed usarne tutti i metodi. 

Alla riga 5 viene creata l’istanza ‘$db’ alla classe ‘database’. Di seguito alla riga 6 il pri¬ 
mo utilizzo del nuovo oggetto con l’apertura della connessione alla base di dati predefinita. 
Come visto precedentemente questo è il passo che permette in caso di necessità di specificare 
parametri di connessione diversi da quelli predefiniti e impostati nella classe di connessione nel 
file ‘brdp_db. php’. 

Nella riga 7 viene assegnata alla variabile ‘$sql’ la query come una semplice stanga, questa 
variabile sarà poi fornita al metodo di esecuzione. 

Segue del semplice codice HTML mentre alla riga 31 viene mostrata la query che verrà eseguita 
in fase di interrogazione. 

Prima di approfondire la parte più interessante dell’esempio è bene ricordare l’importanza della 
gestione degli errori. In questo caso la query è statica dunque una volta testatone il funzionamente 
non si dovrebbero avere problemi inquanto non cambierà nel tempo, spesso però tali stringhe ven¬ 
gono composte usando parametri ricevuti da altre pagine e questo aumenta le probabilità di errore 
dovuti a eccezioni non gestite. La classe in ogni caso nasconde ogni tipo di errore dell’interprete 
PHP ma per realizzare un codice professionale non basta, bisogna anche informare il visitatore di 
cosa sta succedendo o comunque informarlo della generazione di un errore. 

L’esecuzione della query avviene alla riga 40 ed avviene all’interno di un’istruzione ‘if ’, questo 
perchè il metodo torna un valore falso in caso di errore e di conseguenza mostra al visitatore il 
messaggio della riga 55. 

Se la query viene eseguita senza errori l’interprete continua con l’esecuzione della riga 4L Nel¬ 
l’esempio in oggetto viene eseguita una SELECT dunque il risultato sarà un array associativo con 
5 colonne ed ‘n’ righe. A priori non si conosce il numero di voci restituite dalla query per questo, 
alla riga 41, prima di visualizzare le voci viene controllata la quantità di righe tramite il meto¬ 
do ‘righe () ’, se è zero viene informato il visitatore che non sono state trovate voci in archivio 
altrimenti viene mostrate) il risultato. 

Dalla riga 42 alla 50 viene visualizzato il risultato della SELECT mediante un ciclo ‘for’. È 
importante notare come si parta dal valore 0 e si incrementi ‘$db->righe ( ) ’ volte. 

I valori vengono visualizzati mediante il metodo ‘leggio’ che accetta il numero di riga da 
leggere e il nome della colonna (campo della tabella) da estrarre. Il funzionamento è semplice e 
intuitivo, e si può trattare il metodo come una semplice variabile ad esempio leggendo l’i-esimo 
nome come di seguito: 



Il PHP e le base di dati 


85 


# assegnazione ad una variabile 
$nome = $db->leggi($ì,"nome"); 

# visualizzazione diretta dell'i-esìmo nome 
echo $db->leggi($i,"nome"); 

# Concatenazione con una stringa 

echo "Ecco il nome del fortunato: ".$db->leggi($ì,"nome"); 

# utilizzo con funzioni predefinìte 

echo "tolgo gli eventuali spazi a destra: ".rtrim($db->leggi($i,"nome")); 


Mentre si visualizza il risultato vengono costruiti dinamicamente i collegamenti alle pagine di 
dettaglio e agenda relative all’utente in oggetto. Il risultato dello script è riportato in fìgura lTTdl 

Figura[L2l L'elenco utenti e i collegamenti vengono creati dinamicamente in seguito 
all'interrogazione della base di dati. 



7.4 II metodo query2select 

Nella programmazione di tutti i giorni si ripetono molte operazioni: una, ad esempio, è la re¬ 
alizzazione di una lista partendo dai dati contenuti in una o più tabelle di una base di dati. Il 
metodo ‘query2select’ permette di formattare i dati ottenuti tramite una SELECT SQL in una 
SELECT HTML. Il risultato è mostrato in figura 1731 

Il codice per ottenere tale risultato è il seguente: 

1 <? 

2 # Includo la classe per la gestione della base dì dati 

3 include("brdp_db.php"); 

4 

5 $db = new database; 

6 $db->connetti(); 

7 

8 $sql = "select * from BRDP_TB_AGENDA where id_utente=".$HTTP_GET_VARS["utente"] 


9 ?> 
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10 

11 <html> 

12 <head> 

13 <title>Agenda utenti</title> 

14 </head> 

15 <body> 

16 

17 <br> 

18 [ 

19 <a href="">HOME</a> - 

20 <a href="../">ESEMPI</a> - 

21 <a href="index.php">Inizio ESEMPIO</a> 

22 ] 

23 <brxbr> 

24 Esempio di <b>interrogazione di base di dati</b>. 

25 <brxbr> 

26 Viene eseguita una SELECT sulla tabella <b>BRDP_TB_AGENDA</b> 

27 per visualizzare i contatti relativi all'utente con id_utente pari al 

28 parametro passato con il nome di "utente". 

29 La Query da eseguire è la seguente: 

30 <brxbr> 

31 <ix?=$sql?x/i> 

32 <brxbr> 

33 Questo il risultato della query tramite il metodo <bxi>query2select</ix/b> : 

34 <brxbr> 

35 

36 <form method="get" action="contatto.php" name="dettagli_contatto"> 

37 ecco i contatti dell'utente <bx?=$HTTP_GET_VARS [ "nome" ] ?x/b> : &nbsp; 

38 <select name="contatto"> 

39 <? 

40 $db->query2select($sql,"nome","id_agenda",false,true); 

41 ?> 

42 </select> &nbsp; 

43 <input type="submit" value="mostra dettaglì"> 

44 </form> 

45 

46 </body> 

47 </html> 

48 

49 

50 <? 

51 # chiusura della connessione alla base dati è importante! 

52 $db->disconnetti(); 

53 ?> 

Il codice è molto simile all’esempio precedente, quindi non necessita di particolari spiegazioni. 
La parte da analizzare è la riga 40 dove viene utilizzato il metodo in analisi; i parametri da passare 
sono cinque: la stringa contenente la SELECT SQL, il campo da mostrare nella SELECT HTML 
(in questo caso nome), il campo da impostare come valore dell’attributo ‘value’ della scelta 
HTML. Il metodo inoltre accetta un eventuale valore da impostare come selezionato se trovato 
tra i valori estratti dalla base di dati (se falso allora nessun valore sarà selezionato). Infine si trova 
il metodo di risposta, ovvero il modo in cui il risultato deve essere restituito; se il parametro è 
vero mostra a video i dati estratti e formattati, altrimenti se è falso li ritorna come valore. 
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Figura [73] Il metodo query2select esegue la query e restituisce direttamente valori in 
una SELECT HTML. 



Analizzando il sorgente della pagina visualizzata sul navigatore si capisce meglio il funzion¬ 
amento e l’utilizzo dei parametri passati al metodo. Questo è ciò che viene generato dal 
metodo: 

<form method="get" action="contatto.php" name="dettagli_contatto"> 
ecco i contatti dell'utente <b>Gianluca</b>: Snbsp; 

<select name="contatto"> 

<optìon value="l" >Bìanchi</option> 

<optìon value="2" >Rossi</optìon> 

<optìon value="5" >Francesco</option> 

</select> Snbsp; 

<input type="submit" value="mostra dettagli"> 

</form> 


Se la riga 40 fosse stata questa: 

40 $db->query2seleet($sql,"nome","ìd_agenda","Rossi",true); 


il risultato ottenuto sarebbe stato: 

<form method="get" action="contatto.php" name="dettagli_contatto"> 
ecco i contatti dell'utente <b>Gianluca</b>: Snbsp; 

<select name="contatto"> 

<optìon value="l" >Bìanchi</option> 

<optìon value="2" selected>Rossi</option> 

<optìon value="5" >Francesco</option> 

</select> Snbsp; 

<input type="submit" value="mostra dettagli"> 

</form> 


Ovvero l’utente "Rossi" sarebbe stato impostato come selezionato, questo risulta comodo nelle 
maschere di modifica dove esiste già un valore da visualizzare come predefinito. 
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7.5 Costruzione dinamica delle query 


Come anticipato nei capitoli precedenti le query possono essere composte dinamicamente 
utilizzando il PHP. 

I collegamenti realizzati nel precedente esempio forniscono tramite il metodo get uno o più 
parametri alle pagine di destinazione. Si prenda in considerazione lo script ‘dettagli .php’ 
che riceve il parametro 'utente’. Tale pagina effettuerà una SELECT nella tabella 
BRDP_TB_UTENTI della base di dati estraendo i dati relativi all’utente con ìd_utente uguale 
al valore ricevuto in get da ‘index. php’. Con il codice seguente si otterrà il risultato mostrato in 
figura |731 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 


<? 

# Includo la classe per la gestione della base di dati 
include("brdp_db.php"); 

$db = new database; 

$db->connetti ( ); 

$sql = "SELECT * from BRDP_TB_UTENTI where id_utente=".$HTTP_GET_VARS["utente"]; 

?> 

<html> 

<head> 

<title>Dettagli utente</title> 

</head> 

<body> 

<br> 

[ 

<a href="../../">HOME</a> - 

<a href="../">ESEMPI</a> - 

<a href="index.php">Inizio ESEMPIO</a> 

] 

<brxbr> 

Esempio di <b>interrogazione di base di dati</b>. 

<brxbr> 

Viene eseguita una SELECT sulla tabella <b>BRDP_TB_UTENTI</b> 
per visualizzare i dettagli dell'utente con id_utente pari al 
parametro passato con il nome dì "utente". 

La Query da eseguire è la seguente: 

<brxbr> 

<iX?=$sql?X/i> 

<brxbr> 

Questo il risultato della query: 

<brxbr> 

<table> 

<? 

# eseguo la query 
if($db->esegui($sql)){ 
ìf($db->righe()==1){ 

echo "<trxtd>Codice : </td> <td>" . $db->leggi (0, "id_utente" ) . "</tdx/tr>"; 
echo "<trxtd>Nome : </td> <td>" . $db->leggi (0, "nome" ) . "</tdx/tr>"; 
echo "<trxtd>Cognome : </td> <td>" . $db->leggi (0, "cognome" ) . "</tdx/tr>" ; 
echo "<trxtd>e-mail : </td> <td>" . $db->leggi (0, "email" ) . "</tdx/tr>" ; 
echo "<trxtdx/td> <tdxa href=\"agenda.php?utente="; 

echo $db->leggi($i,"id_utente")."&nome=".$db->leggi(0,"nome")."\">Agenda utente</a> 
</tdx/tr>" ; 

}else{ 

echo "<trxtd>Nessun utente attivo in archivio con questo codice</tdx/tr>" ; 

} 

}else{ 
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51 echo "<tr><td>Errore dì interrogazione.</tdx/tr>"; 

52 } 

53 ?> 

54 </table> 

55 

56 </body> 

57 </html> 

58 

59 

60 <? 

61 # chiusura della connessione alla base dati è importante! 

62 $db->disconnetti(); 

63 ?> 

Oltre a cambiare il modo di formattazione del risultato, varia la costruzione della query; questa 
volta, infatti, viene assemblata usando un parametro ricevuto da un’altra pagina. Nell’esempio 
non vengono effettuati controlli sul valore di tale variabile, ma in circostanze più serie è buona 
norma verificare almeno il tipo di dato e se la variabile è nulla. Ad esempio, in questo caso ci si 
aspetta un valore intero (il codice utente). Il controllo viene lasciato come esercizio al lettore. 

Nell’esempio la query è molto semplice ma spesso ci si trova ad operare con strutture più com¬ 
plesse e con vari parametri da filtrare per ogni interrogazione; in queste situazioni è importante 
gestire tutte le possibili eccezioni in modo da eliminare eventuali errori. 

Figura[T4] Con la condizione where viene selezionato un solo utente, La query viene 
generata dinamicamente. 



In questo caso il risultato considerato corretto deve fornire una sola, riga dunque il controllo è 
quello della riga 41 oltre al solito sull’esecuzione alla riga 40. 

Inoltre, essendo una sola riga non si ha bisogno di ciclare l’array; di conseguenza al metodo 
‘leggi () ’ viene passato direttamente il valore 0 pari alla prima riga. 
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7.6 Altri tipi di query 

Come più volte sottolineato, questa non vuole essere una guida sull’SQL; tuttavia non esiste il 
solo comando SELECT ma è possibile inserire, aggiornare e rimuovere dei valori dalla base di 
dati, oltre a svariate altre operazioni che esulano dall’obiettivo di questa guida e che quindi non 
verranno trattate. 

Di seguito verrà osservato il comportamento del PHP nel gestire istruzioni che non restituiscono 
dei valori, come nel caso del comando SELECT, ma che restituiscono un valore falso se qualcosa 
è andato storto. 

Prima di analizzare il codice è bene ricordare che è di fondamentale importanza la gestione di 
eventuali errori e dei messaggi restituiti dal DBMS. 

Si supponga di aver ricevuto dei dati da un modulo HTML e di voler inserire tali infor¬ 
mazioni nella tabella dei contatti BRDP_TB_AGENDA . I dati da gestire sono: nome, cognome, 
email, telefono, fax e utente. Va ricordato che la tabella in oggetto è relazionata alla tabel¬ 
la BRDP_TB_UTENTI dunque la nuova riga che si andrà ad inserire dovrà in qualche modo 
riferirsi ad un utente contenuto nella tabella degli utenti. Il dato che permette di mantenere tale 
relazione è passato dal modulo con la variabile ‘utente’, che dunque deve essere un intero. 

Questa è la porzione di codice che gestisce l’inserimento: 

<? 

# Includo la classe per la gestione della base dì dati 
include("brdp_db.php" ) ; 

$db = new database; 

$db->connetti() ; 

$sql = " INSERT 

into BRDP_TB_AGENDA 
( 

id_utente, 

nome, 

cognome, 

email, 

telefono, 

fax 

) values ( 

".$HTTP_GET_VARS["utente"].", 

, i. _ $HTTP_GET_VARS [ "nome 
,„_ $htTP_GET_VARS[" cognome"] ." ' , 

,„_ $htTP_GET_VARS[" email"] . " ' , 

, „_ $HTTP_GET_VARS["tei " ] . " ' , 

' ".$HTTP_GET_VARS["fax"] ."' 

) 


if($db->esegui($sql) ) { 

echo "Inserimento eseguito."; 

}else{ 

echo "Problemi durante l'inserimento."; 

} 


# chiusura della connessione alla base dati è importante! 
$db->disconnetti (); 

?> 


Va notato come i valori di tipo non numerico vadano racchiusi tra il singolo apice, mentre, i 
numerici possono essere passati direttamente. 
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L’indentazione della query non è obbligatoria, ma in casi di interrogazioni complesse aiuta ad 
individuare eventuali errori in fase di correzione: dunque è consigliata. 

Il funzionamento del comando UPDATE è simile all’inserimento e permette di modificare uno o 
più campi di una tabella tramite le condizioni della clausula WHERE. 

Di seguito un esempio di una porzione di codice SQL che gestisce un aggiornamento. 

<? 

# Includo la classe per la gestione della base dì dati 
include("brdp_db.php" ) ; 

$db = new database; 

$db->connetti( ) ; 

$sql = " update 

BRDP_TB_AGENDA 

set 

Nome = ' ".$HTTP_GET_VARS["nome"] ." ' , 

Cognome = $HTTP_GET_VARS["cognome"]."' , 
email = $HTTP_GET_VARS["email"]."' , 

telefono = '".$HTTP_GET_VARS["tei"], 
fax = ' ".$HTTP_GET_VARS["fax"] ." ' 
where 

id_agenda = $HTTP_GET_VARS["contatto"]." 


if($db->esegui($sql)){ 

echo "Modifica completata eseguito."; 
}else{ 

echo "Problemi durante la modifica."; 

} 


# chiusura della connessione alla base dati è importante! 
$db->disconnetti (); 

?> 


Come è facile notare, la gestione della query dal punto di vista dell’interprete PHP è del tutto 
identica alla INSERT ed alla DELETE che viene riportata di seguito. 

<? 

# Includo la classe per la gestione della base dì dati 
include("brdp_db.php") ; 

$db = new database; 

$db->connetti() ; 

$sql = " delete from 

BRDP_TB_AGENDA 

where 

id_agenda = $HTTP_GET_VARS["contatto"]. " 


if($db->esegui($sql) ) { 

echo "Modifica completata eseguito."; 
}else{ 

echo "Problemi durante la modifica."; 

} 


# chiusura della connessione alla base dati è importante! 
$db->disconnetti (); 

?> 
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Nelle operazioni di cancellazione e modifica è importante ponderare le condizioni altrimenti tutti 
i campi verranno interessati. Ad esempio, una query come: ‘delete from BRDP_TB_AGENDA’ 
svuota la tabella BRDP_TB_AGENDA di tutto il suo contenuto. 

A seguito di un’inteiTogazione è possibile ottenere informazioni più dettagliate, come il numero 
di righe interessate dall’operazione, o ancora gestire i singoli tipi di errori del DBMS. Per quanto 
interessante, questo aspetto esula dallo scopo della guida ma rimane un ottimo esercizio per quanti 
vogliano approfondire l’argomento. 

7.7 Applicazioni pratiche, gestione di una rubrica 

Come esempio nei capitoli precedenti si è trattata la gestione di una semplice agenda multiutente; 
di seguito essa verrà completata in modo da aumentare la dimestichezza con gli argomenti fin qui 
trattati. 

Nella directory contenente gli esempi - raggiungibile qui: <http:,'.'www.urcanet.it'brdp/php_manuaL;sem- 
pi/> - alla sezione riservata al capitolo 8, si trovano due file ‘index.php’ e ‘menu. php’ ; tramite 
il primo si accede agli esempi visti fino ad ora, mentre scegliendo il secondo si tratteranno gli 
script di seguito implementati mediante i quali sarà possibile aggiungere, modificare e rimuo¬ 
vere i contatti dell’utente selezionato. Il codice visto fino ad ora e quello che segue non cura la 
parte estetica per non appesantire il codice con porzioni di HTML che renderebbero soltanto più 
faticosa la lettura del listato. 

Partendo dal file ‘menu.php’, quello che si ottiene è una pagina di selezione simile a quella 
riportata in figura 1731 

Fiaura lTfil La pagina di selezione permette di scegliere l'operazione da effettuare sui 
contatti dell'utente associato, 



Tramite questa pagina iniziale sarà possibile inserire, modificare e cancellare i contatti degli utenti 
attivi in archivio. Il codice dello script trattato è il seguente: 

1 <? 

2 # Includo la classe per la gestione della base di dati 

3 include("brdp_db.php"); 

4 
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5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 

16 

17 

18 

19 

20 
21 
22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 


$db = new database; 

$db->connetti() ; 

$sql = "select * from BRDP_TB_UTENTI where attivo=l"; 

?> 

<html> 

<head> 

<title>Agenda utenti</title> 

</head> 

<body> 

<br> 

[ 

<a href="../../">HOME</a> - 
<a href="../">ESEMPI</a> 

] 

<brxbr> 

Esempio di <b>interrogazione di base di dati</b>. 

<brxbr> 

Viene eseguita una SELECT sulla tabella <b>BRDP_TB_UTENTI</b> 
di tutti gli utenti attivi. <br>Poi viene visualizzato l'elenco con 
un collegamento generato dinamicamente alla pagina di inserimento, modifica 
e cancellazione. <br>Dunque da qui verranno richiamate le pagine 
di gestione dei contatti. 

<brxbr> 

<ix?=$sql?x/i> 

<brxbr> 

Questo il risultato della query tramite il metodo <bxi>esegui</ix/b> : 

<brxbr> 

Gestisci i contatti dell'utente :<br> 

<ul > 

<? 

if($db->esegui($sql) && $db->righe()>0){ 

$i=0; 

while($i<$db->righe()){ # Questa volta utilizziamo un while 

?> 

<li> <?=$db->leggi($i,"nome")." ".$db->leggi($i,"cognome")?> 

-> <a href="inserisci_edita.php?utente=<?=$db->leggi($i,"id_utente")?>"> 

<b> Inserì sci </bx/a> 

<a href="cancella_scegli.php?utente=<?=$db->leggi($i,"id_utente")?>"> 
<b>Cancella</bx/a> 

<a href="modifica_scegli.php?utente=<?=$db->leggi($i,"id_utente")?>"> 
<b>Modif ica</bx/a> 

<? 

$ i + + ; 

} 

}else{ 

echo "<li>Spiacente, nessun utente attivo!"; 

} 

?> 

</ul> 

</body> 

</html> 

<? 

# chiusura della connessione alla base dati è importante! 

$db->disconnetti() ; 

?> 


In linea di principio è molto simile alle precedenti, esegue, infatti, un'interrogazione alla base 
di dati e cicla tramite una struttura ‘while’ i valori attenuti. Nel ciclo vengono anche creati 
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i collegamenti alle pagine di gestione passando, in modo dinamico, l’identifìcativo dell’utente 
proprietario dei contatti. In particolare ci si riferisce alle righe 44, 45 e 46. 


7.7.1 Inserimento di un nuovo contatto 


Di seguito si analizzerà l’inserimento di un nuovo contatto, effettuato tramite una maschera di 
inserimento dati che viene inviata ad una seconda pagina la quale effettua il salvataggio dei dati 
nella tabella BRDP_TB_AGENDA . 

Il file ‘inserisci_edita .php’ permette di editare i campi di testo che verranno spediti al file 
‘inserisci_salva.php’, il quale salverà i dati in archivio senza effettuare controlli di alcun 
genere: dunque anche i campi vuoti saranno inseriti. 

In un sito curato e sicuro vengono effettuati controlli JavaScript al momento dell’inoltro del mod¬ 
ulo, questo aspetto esula dallo scopo della guida ma è bene tenerlo presente al momento della 
scrittura di un codice efficiente e professionale. 

Di seguito il listato della pagina contenente la maschera di inserimento: 

1 

2 <html> 

3 <head> 

4 <title>Agenda utenti</title> 

5 </head> 

6 <body> 

7 

8 <br> 

9 [ 

10 <a href="../../">HOME</a> - 

11 <a href="../">ESEMPI</a> - 

12 <a href="menu,php">Inizio ESEMPIO</a> 

13 ] 

14 <brxbr> 

15 Esempio di <b>inserimento valori in una base di dati</b>. 

16 <brxbr> 

17 In questa pagina non viene eseguita nessuna connessione alla base di dati.<br> 

18 Viene richiesto l'inserimento dei dati da salvare nell'agenda dell'utente scelto 

19 nella pagina precedente. 

20 <brxbr> 

21 

22 <form actìon="inserisci_salva.php" method="get"> 

23 

24 <input type="hidden" name="utente" value="<?=$HTTP_GET_VARS["utente"]?>"> 

25 

26 Nome: <input type="text" name="nome" size="30" maxlength="30"xbr> 

27 Cognome: <input type="text" name="cognome" size="30" maxlength="30"xbr> 

28 e-maìl: <input type="text" name="email" size="30" maxlength="30"xbr> 

29 Telefono: <input type="text" name="tel" size="20" maxlength="20"xbr> 

30 Fax: <input type="text" name="fax" size="20" maxlength="20"xbrxbr> 

31 

32 <input type="reset" value="ANNULLA"> 

33 <input type="submit" value="INSERISCI"> 

34 

35 </form> 

36 

37 </body> 

38 </html> 

39 


Non ci sono particolari complicazioni, il codice è puro HTML che formatta il modulo. Va notato 
però che alla riga 24 viene passato in modo nascosto il valore dell’identificativo dell’utente prò- 
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prietario del nuovo contatto, esso viene preso dall’array ‘$HTTP_GET_VARS’ dei valori ricevuti 
tramite il metodo get e inviato alla pagina successiva. 

Come è facile immaginare il risultato del listato appena visto è il seguente: 

Figura [TTó] Da questa pagina è possibile inserire il nuovo contatto per l'utente 
precedentemente selezionato. 



Il file ‘inserisci_salva .php’ riceve i valori e li formatta nella sintassi SQL che effettua una 
INSERT nella tabella. Ecco il codice nel dettaglio: 


1 

<? 


2 

# Includo 

la classe per la gestione della ba 

3 

include(" 

brdp_db.php"); 

4 



5 

$db = new 

database; 

6 

$db->connetti(); 

7 



8 

settype($HTTP_GET_VARS["utente"],integer); 

9 



10 

$sql = " 

insert into BRDP_TB_AGENDA 

11 


( 

12 


id_utente. 

13 


Nome, 

14 


Cognome, 

15 


email, 

16 


telefono. 

17 


fax 

18 


)values( 

19 


".$HTTP_GET_VARS["utente"].", 

20 


,»_ $HTTP_GET_VARS["nome"] ."', 

21 


,»_ $HTTP_GET_VARS["cognome"] ." ' 

22 


,»_ $HTTP_GET_VARS["email"] ., 

23 


,»_ $HTTP_GET_VARS["tei"] ." ' , 

24 


, U _ $HTTP_GET_VARS["fax"] ." ' 

25 


) 

26 

H . 


27 

?> 


28 



29 

<html> 


30 

<head> 
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31 

32 

33 

34 

35 

36 

37 

38 

39 

40 

41 

42 

43 

44 

45 

46 

47 

48 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 

59 

60 
61 
62 

63 

64 

65 

66 

67 

68 

69 

70 

71 

72 

73 

74 

75 

76 

77 

78 

79 

80 


<title>Agenda utenti</title> 

</head> 

<body> 

<br> 

[ 

<a href="../../">HOME</a> - 
<a href="../">ESEMPI</a> - 
<a href="menu,php">Inizio ESEMPIO</a> 

] 

<brxbr> 

Esempio di <b>interrogazione di base di dati</b>. 

<brxbr> 

Viene eseguita una INSERT sulla tabella <b>BRDP_TB_AGENDA</b> 
relazionando il nuovo contatto con l'utente tramite il campo id_utente 
<brxbr> 

<ix?=$sql?x/i> 

<brxbr> 

Questo il risultato della query tramite il metodo <bxi>esegui</ix/b> : 
<brxbr> 

Salvataggio nuovo contatto nell'agenda dell'utente 
con id_utente: <?=$HTTP_GET_VARS["utente"]?xbr> 

<ul> 

<? 

if($HTTP_GET_VARS["utente"]!="" && $HTTP_GET_VARS["utente"]!=0){ 
if($db->esegui($sql)){ 

echo "<li> <b>Inserimento eseguito Correttamente</b>!"; 

# estraggo l'id del nuovo contatto 

echo "<br> l'ID del nuovo contatto è: ".$db->getlast_id(); 

}else{ 

echo "<li> <b>Inserimento NON eseguito</b>."; 

} 

}else{ 

echo "<li> Il percorso seguito non è corretto! Partire da 'menu.php'" 

} 

?> 

</ul> 

<br> 

<a href="agenda.php?utente=<?=$HTTP_GET_VARS["utente"]?>"> 

Visualizza l'agenda aggiornata</a>. 

</body> 

</html> 

<? 

# chiusura della connessione alla base dati è importante! 

$db->disconnetti() ; 

?> 


Oltre alle normali operazioni di connessione, viene impostato come intero l’identifìcativo utente 
alla riga 8, poi dalla 10 alla 26 viene formattata la query per rinserimento. Si noti ancora come i 
valori di tipo stringa vengono contenuti tra singoli apici, mentre i valori interi non hanno bisogno 
di limitatori; la stringa, inoltre, è generata dinamicamente in base ai valori ricevuti. 

Alla riga 56 e 57 vengono effettuati due controlli che permettono di evitare comportamenti am¬ 
bigui, anche quando il visitatore arriva per errore nella pagina senza aver seguito il percorso 
corretto, ad esempio in seguito all’apertura della stessa dall’elenco delle preferite. Questo per 
quanto riguarda il primo controllo; il secondo, invece, verifica la corretta esecuzione della query 
come più volte trattato. 
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Più interessante invece è la riga 60 nella quale viene estratto l’identifìcativo del contatto appena 
creato tramite il metodo ‘getlast_id’ della classe "database’. Tale metodo è utilizzabile in 
caso di tabelle aventi come chiave primaria un intero autoincrementante ed è il caso della tabella in 
esempio; l’identificativo del nuovo contatto, infatti, non è stato specificato perchè sarà il DBMS 
ad assegnarlo in modo progressivo ad ogni nuova voce inserita. Ovviamente il valore è l’ultimo 
inserito dalla connessione attiva e non l’ultimo in assoluto dal momento che più visitatori in modo 
concorrente possono inserire valori nella tabella. 

La pagina di salvataggio restituisce la seguente risposta: 

Figura [77] La pagina informa l'utente dell'esito dell'operazione e in caso positivo 

mostra l'ID assegnato al nuovo contatto. 



7.7.2 Rimozione di un contatto 

Oltre all’inserimento, è possibile eliminare e modificare voci già esistenti; di seguito verrà 
trattata la procedura di cancellazione. Come prima cosa va identificata univocamente la voce 
da rimuovere dall’archivio; tramite il menu iniziale cliccando sulla voce "cancella" associa¬ 
ta ad uno degli utenti proprietari di una rubrica si passa il parametro ‘utente’ alla pagi¬ 
na ‘cancella_scegli .php’. Tale file mostrerà tutti i contatti associati all’utente mediante il 
metodo ‘query2select’ mostrando una scelta di questo tipo: 
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Figura [7~8] Tramite questa pagina è possibile scegliere il contatto da rimuovere. 



Il codice, ormai familiare, per ottenere tale risultato è: 

1 <? 

2 # Includo la classe per la gestione della base di dati 

3 include("brdp_db.php"); 

4 

5 $db = new database; 

6 $db->connetti ( ); 

7 

8 $sql = "select * from BRDP_TB_AGENDA where id_utente=".$HTTP_GET_VARS["utente"] 

9 ?> 

10 

11 <html> 

12 <head> 

13 <title>Agenda utenti</title> 

14 </head> 

15 <body> 

16 

17 <br> 

18 [ 

19 <a href=" ../.. /">HOME</a> - 

20 <a href="../">ESEMPI</a> - 

21 <a href="menu,php">Inizio ESEMPIO</a> 

22 ] 

23 <brxbr> 

24 Esempio di <b>interrogazione di base di dati</b>. 

25 <brxbr> 

26 Viene eseguita una SELECT sulla tabella <b>BRDP_TB_AGENDA</b> 

27 per visualizzare l'elenco dei contatti dell'utente.<br> 

28 II contatto scelto potrà essere rimosso. 

2 9 <brxbr> 

30 <ix?=$sql?x/i> 

31 <brxbr> 

32 Questo il risultato della query tramite il metodo <bxi>query2select</ix/b> : 

33 <brxbr> 

34 

35 <form method="get" action="cancella_esegui.php"> 

36 <input type="hidden" name="utente" value="<?=$HTTP_GET_VARS["utente"]?>"> 

37 Seleziona il contatto da eliminare <bx?=$HTTP_GET_VARS [ "nome" ] ?x/b> : Snbsp; 
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38 <select name="contatto" onchange> 

39 <option value="Nessuno" selected>Nessuno</option> 

40 <? 

41 $db->query2select($sql, "nome", "id_agenda", false, true); 

42 ?> 

43 </select> &nbsp; 

44 <input type="submit" value="Elimina selezionato"> 

45 </form> 

46 

47 </body> 

48 </html> 

49 

50 

51 <? 

52 # chiusura della connessione alla base dati è importante! 

53 $db->disconnetti(); 

54 ?> 

Il metodo trattato è stato ampliamente spiegato, da notale, ancora, la costruzione dinamica della 
query nella riga 8, al lettore il compito di implementare i controlli del caso. 

Il modulo HTML trasmette il codice utente ottenuto in questa pagina insieme al codice del 
contatto scelto per essere rimosso. Di seguito il codice della pagina che effettua la rimozione. 

1 <? 

2 # Includo la classe per la gestione della base di dati 

3 include("brdp_db,php"); 

4 

5 $db = new database; 

6 $db->connetti() ; 

7 

8 settype($HTTP_GET_VARS["utente"] , integer) ; 

9 

10 $sql = " delete from BRDP_TB_AGENDA where ìd_agenda = ",$HTTP_GET_VARS["contatto"] 

11 ?> 

12 

13 <html> 

14 <head> 

15 <title>Agenda utenti</title> 

16 </head> 

17 <body> 

18 

19 <br> 

20 [ 

21 <a href="../../">HOME</a> - 

22 <a href="../">ESEMPI</a> - 

23 <a href="menu.php">Inizio ESEMPIO</a> 

24 ] 

25 <brxbr> 

26 Esempio di <b>interrogazione di base di dati</b>. 

27 <brxbr> 

28 Viene eseguita una DELETE sulla tabella <b>BRDP_TB_AGENDA</b> 

29 per eliminare gli utenti con id_agenda pari al valore ricevuto 

30 dalla select precedente. 

31 <brxbr> 

32 <ix?=$sql?x/i> 

33 <brxbr> 

34 Questo il risultato della query tramite il metodo <bxi>esegui</ix/b> : 

35 <brxbr> 

36 

37 Cancellazione di un contatto dall'agenda dell'utente :<br> 

38 <ul> 

39 <? 

40 if($HTTP_GET_VARS["contatto"]!="" && $HTTP_GET_VARS["contatto"]!=0){ 

41 if($db->esegui($sql)){ 
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42 echo "<li> <b>Cancellazione eseguita Correttamente</b>!"; 

43 }else{ 

44 echo "<li> <b>Cancellazione NON eseguita</b>."; 

45 } 

46 }else{ 

47 echo "<li> Nessun contatto specificato."; 

48 } 

49 ?> 

50 </ul> 

51 

52 <br> 

53 <a href="cancella_scegli,php?utente=<?=$HTTP_GET_VARS["utente"]?>"> 
Cancella un altro contatto</a>. 

54 

55 

56 </body> 

57 </html> 

58 

59 

60 <? 

61 # chiusura della connessione alla base dati è importante! 

62 $db->disconnetti(); 

63 ?> 


Come al solito la query viene costruita utilizzando i parametri ricevuti dalla pagina precedente. 
Prima di procedere è bene fai - notare che un parametro ricevuto non viene utilizzato; questa non 
è una distrazione di chi scrive, è semplicemente compito del lettore inserirlo in modo corretto 
nella query. Ovviamente il funzionamento è garantito anche in questa versione del codice grazie 
all’univocità della chiave di identificazione del contatto. 

Alla riga 40 viene controllato che sia stato specificato il codice della voce da rimuovere, senza 
controllare che si tratti di un intero. Si provi a modificare la barra dell’indirizzo assegnando una 
stringa al parametro rappresentante il codice del contatto per verificare la gestione dell’errore. 
Con l’aggiunta di un controllo si può gestire più in dettaglio l’anomalia, l’esercizio è lasciato al 
lettore. 

Alla riga 41 viene controllata l’esecuzione dell’istruzione, il risultato di questo programma è il 
seguente: 
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Figura[T9] Il risultato dell'operazione di rimozione, 



7,7,3 Modifica di un contatto 

Per rendere funzionante il prototipo di questa rudimentale rubrica non manca che implementare 
la parte di modifica dei contatti presenti in archivio. Partendo dal file principale ‘menu.php’, 
scegliendo la voce "modifica" si accede alla pagina ‘modif ica_scegli .php’ che permette di 
scegliere il contatto da editare; questa pagina è un clone di ‘cancella_scegli .php’, con Puni¬ 
ca differenza sulla pagina di destinazione a cui punta, dunque risulta inutile riproporne il codice. 
Ecco come si presenta: 

Figura 17.101 Del tutto simile a cancella_scegli.php; a cambiare è la pagina di 
destinazione modìfica_modifica.php, 
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La modifica avverrà tramite una maschera simile a quella di inserimento, con la differenza che 
i campi saranno valorizzati con i dati presenti nella base di dati, in modo che il visitatore pos¬ 
sa modificare uno o più campi e salvale i nuovi valori. Il codice per ottenere tale risultato è il 
seguente: 

1 <? 

2 # Includo la classe per la gestione della base di dati 

3 include("brdp_db.php") ; 

4 

5 $db = new database; 

6 $db->connetti( ) ; 

7 

8 $sql = "select * from BRDP_TB_AGENDA where id_agenda=".$HTTP_GET_VARS["contatto" ] ; 

9 ?> 

10 

11 <html> 

12 <head> 

13 <title>Agenda utenti</title> 

14 </head> 

15 <body> 

16 

17 <br> 

18 [ 

19 <a href="../../">HOME</a> - 

20 <a href="../">ESEMPI</a> - 

21 <a href="menu,php">Inizio ESEMPIO</a> 

22 ] 

23 <brxbr> 

24 Esempio di <b>interrogazione di base di dati</b>. 

25 <brxbr> 

26 Viene eseguita una SELECT sulla tabella <b>BRDP_TB_AGENDA</b> 

27 per visualizzare i campi relativi al contatto da modificare. 

28 <brxbr> 

29 <ix?=$sql?x/i> 

30 <brxbr> 

31 Ecco i valori ottenuti tramite il metodo <bxi>esegui</ix/b> 

32 <brxbr> 

33 

34 <? if($db->esegui($sql) && $db->righe()==1){ ?> 

35 <form method="get" action="modifica_salva.php"> 

36 <input type="hidden" name="utente" value="<?=$HTTP_GET_VARS["utente"]?>"> 

37 <input type="hidden" name="contatto" value="<?=$HTTP_GET_VARS["contatto"]?>"> 

38 

39 Nome: <input type="text" name="nome" value="<?=$db->leggi(0,"nome")?>" size="30" 
maxlength="30"xbr> 

40 Cognome: <input type="text" name="cognome" value="<?=$db->leggi(0,"cognome")?>" 
size="30" maxlength="30"xbr> 

41 e-mail: <input type="text" name="emaìl" value="<?=$db->leggi(0,"email")?>" 
sìze="30" maxlength="30"xbr> 

42 Telefono: <input type="text" name="tel" value="<?=$db->leggi(0,"telefono")?>" 
size= " 20 " maxlength= "20"xbr> 

43 Fax: <input type="text" name="fax" value="<?=$db->leggi(0,"fax")?>" size="20" 
maxlength="20"xbrxbr> 

44 

45 <input type="reset" value="Annulla le modifiche"> 

46 &nbsp;&nbsp;&nbsp; 

47 <input type="submit" value="Salva le modifiche"> 

48 </form> 

49 <? }else{ ?> 

50 <b>Nessun utente da modificare.</b> 

51 <? } ?> 

52 

53 <br> 

54 <a href="modifica_scegli,php?utente=<?=$HTTP_GET_VARS["utente"]?>">Scegline un altro</a>. 

55 
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56 </body> 

57 </html> 

58 

59 

60 <? 

61 # chiusura della connessione alla base dati è importante! 

62 $db->disconnetti(); 

63 ?> 


L’interazione del PHP con l’HTML in questo esempio è più evidente. Una volta selezionati i dati 
dall’archivio vengono mostrati nei campi del modulo tramite le righe dalla 39 alla 43, mentre alle 
righe 36 e 37 vengono valorizzati i campi nascosti contenenti il valore del codice utente e del 
codice contatto. 

Il controllo alla riga 34 è ormai chiaro, esso verifica che la query venga eseguita correttamente 
e che restituisca una sola riga. Se le due condizioni non si verificano contemporaneamente viene 
visualizzato un messaggio di errore. Questo è il risultato del codice appena visto: 

Figura I7TF1 Tramite il modulo è possibile modificare uno o più campi salvando i nuovi 
valori nella base di dati, 



A questo punto il visitatore può modificare i campi che preferisce ed inviare il tutto alla pagina 
successiva che provvederà al salvataggio nella base di dati dei nuovi valori. Lo script che si occupa 
di questa ultima operazione è ‘modif ica_salva .php’ di cui viene riportato il codice di seguito: 

1 <? 

2 # Includo la classe per la gestione della base di dati 

3 include("brdp_db.php"); 

4 

5 $db = new database; 

6 $db->connetti(); 

7 

8 settype($HTTP_GET_VARS["contatto"],integer); 

9 

10 $sql = " update 
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11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 ?> 

22 

23 <html> 

24 <head> 

25 <title>Agenda utenti</title> 

26 </head> 

27 <body> 

28 

29 <br> 

30 [ 

31 <a href="../../">HOME</a> - 

32 <a href="../">ESEMPI</a> - 

33 <a href="menu,php">Inizio ESEMPIO</a> 

34 ] 

35 <brxbr> 

36 Esempio di <b>interrogazione di base di dati</b>. 

37 <brxbr> 

38 Viene eseguita una UPDATE sulla tabella <b>BRDP_TB_AGENDA</b> 

39 del solo utente con id_contatto pari a quello ricevuto in get 

40 <brxbr> 

41 <ix?=$sql?x/i> 

42 <brxbr> 

43 Questo il risultato della query tramite il metodo <bxi>esegui</ix/b> : 

44 <brxbr> 

45 

46 Salvataggio modifiche :<br> 

47 <ul> 

48 <? 

49 

50 

51 

52 

53 

54 

55 

56 

57 

58 ?> 

59 </ul> 

60 

61 <br> 

62 <a href="agenda.php?utente=<?=$HTTP_GET_VARS["utente"]?>">Visualizza 
l'agenda aggìornata</a>. 

63 

64 </body> 

65 </html> 

66 

67 

68 <? 

69 # chiusura della connessione alla base dati è importante! 

70 $db->disconnetti(); 

71 ?> 


if($HTTP_GET_VARS["contatto"]!="" && $HTTP_GET_VARS["contatto"]!=0){ 
ìf($db->esegui($sql) ) { 

echo "<li> <b>Modifiche salvate Correttamente</b>!"; 

}else{ 

echo "<li> <b>Salavtaggio modifiche NON eseguito</b>."; 

} 

}else{ 

echo "<li> Il percorso seguito non è corretto! Partire da 'menu.php'" 


BRDP_TB_AGENDA 

set 

Nome = '".$HTTP_GET_VARS["nome"] ." ' , 

Cognome = $HTTP_GET_VARS["cognome"' , 
email = $HTTP_GET_VARS["email"' , 
telefono = ' ".$HTTP_GET_VARS["tei"] ."' , 
fax = '".$HTTP_GET_VARS["fax"]. 
where 

id_agenda = $HTTP_GET_VARS["contatto"]."modifica 


Dalla riga 10 alla 20 viene costruita la query, la quale non è complessa ma richiede attenzione 
particolare come nel caso della cancellazione; infatti, se non viene specificata la condizione di 
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WHERE corretta si rischia di apportare la stessa modifica a più righe. Nel caso peggiore si potreb¬ 
bero modificare le righe della tabella rendendole tutte uguali se si omettesse la clausola di riga 18 
e 19. 

Il risultato è simile ai precedenti e viene riportato di seguito: 

Fiaura l7d2l Viene visualizzata la query e mostrato l'esito della sua esecuzione, 



7.8 Conclusioni 

Con la gestione delle modifiche si può considerare completa l’applicazione di esempio; essa ovvi¬ 
amente va presa come un ripetitivo utilizzo dei metodi della classe ‘database’ ed ha come scopo 
unico quello di acquisire dimestichezza con la gestione delle base di dati tramite il PHP. 

Come prima cosa non è stato minimamente tenuto conto dell’aspetto grafico e della impagi¬ 
nazione dei dati: non è una mancanza ma una scelta. In questo modo il codice è velocemente 
leggibile e si è evitato di perdere di vista l’obiettivo degli esempi. Ognuno poi nelle proprie 
applicazioni potrà integrare il codice nella veste grafica del proprio sito come meglio crede. 

Per lo stesso motivo non sono stati implementati controlli JavaScript per non divagare in argomenti 
non strettamente inerenti questa guida. Inutile dire che non si può fare a meno di tali controlli 
in un sito di qualità, l’invito quindi è a documentarsi anche su questo linguaggio se si vuole 
implementare un prodotto di qualità. 

Tutti i controlli sui dati ricevuti dalle pagine di inserimento, cancellazione e modifica sono stati 
trascurati per lo stesso motivo sopra citato. Un esempio per tutti: un indirizzo email non può 
non contenere il carattere ’@’, come deve contenere per forza almeno un carattere ’.’ oltre alla 
lunghezza che non può essere inferiore a sette caratteri (a@bc.de ovviamente è un limite plausi¬ 
bile). Prima di inserire dati in un archivio è bene tenere conto di queste problematiche; si pensi, 
ad esempio, ad una anagrafica utenti di un negozio virtuale in cui la metà degli indirizzi email dei 
clienti registrati è falso o vuoto: non sarà possibile contattare in alcun modo gli utenti iscritti per 
campagne pubblicitarie sui nuovi prodotti. 
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Infine prima di iniziare a lavorare sulla base di dati tramite codice è bene assicurarsi di avere i 
permessi necessari per effettuare le operazioni eseguite nel codice. Se ad esempio l’utente con 
cui ci si collega (impostato nella classe) non ha i permessi di cancellazione, allora una query 
che effettua una ‘DELETE’ non verrà mai eseguita, non a causa di problemi nel codice ma per 
mancanza di permessi nella configurazione del DBMS. Dunque, come prima cosa è bene testare 
il funzionamento dei vari comandi SQL da linea di comando prima di passare all’esecuzione degli 
stessi dal PHP. 
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Capitolo 


Nelle prossime puntate 

Questo è un capitolo che sta per sparire. L’ho inserito solo per informarvi su gli argomenti che 
mi piacerebbe trattale. 

In questi anni di sviluppo di progetti in PHP ho raccolto oltre all’esperienza varie porzioni di 
codice che mi piacerebbe condividere con tutti quelli che, come me, ne hanno bisogno. Spesso 
ho perso molto tempo a risolvere problemi che con un piccolo suggerimento avrei superato in 
pochi minuti. Credo che con la condivisione del proprio lavoro si possa ottimizzare e migliorare 
il proprio codice fino a renderlo umanamente perfetto. Insomma credo nell’Open Source e spero 
che chi leggerà questi appunti e utilizzerà il mio codice, se non lo ha già fatto, si avvicini a questo 
modo di ragionare e di operare. 

Ecco gli argomenti che mi prefìggo di trattare nelle prossime puntate: 

• Cookies e Session ; per la gestione delle sessioni di navigazione; 

• Uploadfile ; è possibile anche tramite il protocollo HTTP 

Grazie a chi legge. Alla prossima... 

BRDP 
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Nelle prossime puntate 



Appendici 



GNU GENERAL PUBLIC LICENSE 


Appendice 


non modificabile 


Testo originale: <http://www.fsf.org, ':opyleft'gpl.html> 


GNU GENERAL PUBLIC LICENSE - Version 2, June 1991 

Copyright (C) 1989, 1991 Free Software Foundation, Ine. 

675 Mass Ave, Cambridge, MA 02139, USA 
Everyone is permitted to copy and distrìbute verbatim copies 
of thìs license document, but changing it is not allowed. 


Preamble 

The licenses for most software are designed to take away your freedom to share and change it. 
By contrast, thè GNU General Public License is intended to guarantee your freedom to share 
and change free software—to make sure thè software is free for all its users. This General Public 
License applies to most of thè Free Software Foundation’s software and to any other program 
whose authors commit to using it. (Some other Free Software Foundation software is covered by 
thè GNU Library General Public License instead.) You can apply it to your programs, too. 

When we speak of free software, we are referring to freedom, not price. Our General Public 
Licenses are designed to make sure that you have thè freedom to distribute copies of free software 
(and charge for this Service if you wish), that you receive source code or can get it if you want it, 
that you can change thè software or use pieces of it in new free programs; and that you know you 
can do these things. 

To protect your rights, we need to make restrictions that forbid anyone to deny you these rights 
or to ask you to su prender thè rights. These restrictions translate to certain responsibilities for you 
if you distribute copies of thè software, or if you modify it. 

For example, if you distribute copies of such a program, whether gratis or for a fee, you must give 
thè recipients all thè rights that you have. You must make sure that they, too, receive or can get 
thè source code. And you must show them these terms so they know their rights. 

We protect your rights with two steps: (1) copyright thè software, and (2) offer you this license 
which gives you legai permission to copy, distribute and/or modify thè software. 

Also, for each author’s protection and ours, we want to make certain that everyone understands 
that there is no warranty for this free software. If thè software is modifìed by someone else and 
passed on, we want its recipients to know that what they have is not thè originai, so that any 
problems introduced by others will not refìect on thè originai authors’ reputations. 

Finally, any free program is threatened constantly by software patents. We wish to avoid thè 
danger that redistributors of a free program will individually obtain patent licenses, in effect 
making thè program proprietary. To prevent this, we have made it clear that any patent must be 
licensed for everyone’s free use or not licensed at all. 

The precise terms and conditions for copying, distribution and modification follow. 

GNU GENERAL PUBLIC LICENSE - TERMS AND CONDITIONS FOR COPYING, 
DISTRIBUTION AND MODIFICATION 

0. This License applies to any program or other work which contains a notice placed by thè 
copyright holder saying it may be distributed under thè terms of this General Public License. The 
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"Program", below, refers to any such program or work, and a "work based on thè Program" rneans 
either thè Program or any derivative work under copyright law: that is to say, a work containing 
thè Program or a portion of it, either verbatim or with modifìcations and/or translated into another 
language. (Hereinafter, translation is included without limitation in thè terni "modifìcation".) Each 
licensee is addressed as "you". 

Activities other than copying, distribution and modifìcation are not covered by this License; they 
ai e outside its scope. The act of running thè Program is not restricted, and thè output from thè 
Program is covered only if its contents constitute a work based on thè Program (independent of 
having been made by running thè Program). Whether that is true depends on what thè Program 
does. 

1. You may copy and distribute verbatim copies of thè Program’s source code as you receive 
it, in any medium, provided that you conspicuously and appropriately publish on each copy an 
appropriate copyright notice and disclaimer of warranty; keep intact all thè notices that refer to 
this License and to thè absence of any warranty; and give any other recipients of thè Program a 
copy of this License along with thè Program. 

You may charge a fee for thè physical act of transferring a copy, and you may at your option offer 
warranty protection in exchange for a fee. 

2. You may modify your copy or copies of thè Program or any portion of it, thus forming a work 
based on thè Program, and copy and distribute such modifìcations or work under thè terms of 
Section 1 above, provided that you also meet all of these conditions: 

a) You must cause thè modifìed fìles to carry prominent notices stating that you 
changed thè fìles and thè date of any change. 

b) You must cause any work that you distribute or publish, that in whole or in part 
contains or is derived from thè Program or any part thereof, to be licensed as a whole 
at no charge to all third parties under thè terms of this License. 

c) If thè modifìed program normally reads commands interactively when run, you 
must cause it, when started running for such interactive use in thè most ordinary way, 
to print or display an announcement including an appropriate copyright notice and a 
notice that there is no warranty (or else, saying that you provide a warranty) and that 
users may redistribute thè program under these conditions, and telling thè user how to 
view a copy of this License. (Exception: if thè Program itself is interactive but does 
not normally print such an announcement, your work based on thè Program is not 
required to print an announcement.) 

These requirements apply to thè modifìed work as a whole. If identifìable sections of that work 
are not derived from thè Program, and can be reasonably considered independent and separate 
works in themselves, then this License, and its terms, do not apply to those sections when you 
distribute them as separate works. But when you distribute thè same sections as part of a whole 
which is a work based on thè Program, thè distribution of thè whole must be on thè terms of this 
License, whose permissions for other licensees extend to thè entire whole, and thus to each and 
every part regardless of who wrote it. 

Thus, it is not thè intent of this section to claim rights or contest your rights to work written 
entirely by you; rather, thè intent is to exercise thè right to control thè distribution of derivative or 
collective works based on thè Program. 

In addition, mere aggregation of another work not based on thè Program with thè Program (or 
with a work based on thè Program) on a volume of a Storage or distribution medium does not 
bring thè other work under thè scope of this License. 
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3. You may copy and distribute thè Program (or a work based on it, under Section 2) in object 
code or executable form under thè terms of Sections 1 and 2 above provided that you also do one 
of thè following: 

a) Accompany it with thè complete corresponding machine-readable source code, 
which must be distributed under thè terms of Sections 1 and 2 above on a medium 
customarily used for software interchange; or, 

b) Accompany it with a written offer, valid for at least three years, to give any third 
party, for a charge no more than your cost of physically performing source distribution, 
a complete machine-readable copy of thè corresponding source code, to be distributed 
under thè terms of Sections 1 and 2 above on a medium customarily used for software 
interchange; or, 

c) Accompany it with thè information you received as to thè offer to distribute corre¬ 
sponding source code. (This alternative is allowed only for noncommercial distribu¬ 
tion and only if you received thè program in object code or executable form with such 
an offer, in accord with Subsection b above.) 

The source code for a work means thè preferred form of thè work for making modifìcations to 
it. For an executable work, complete source code means all thè source code for all modules it 
contains, plus any associated interface definition files, plus thè Scripts used to control compilation 
and installation of thè executable. Flowever, as a special exception, thè source code distributed 
need not include anything that is normally distributed (in either source or binary form) with thè 
major components (compiler, kernel, and so on) of thè operating System on which thè executable 
runs, unless that component itself accompanies thè executable. 

If distribution of executable or object code is made by offering access to copy from a designated 
place, then offering equivalent access to copy thè source code from thè same place counts as 
distribution of thè source code, even though third parties are not compelled to copy thè source 
along with thè object code. 

4. You may not copy, modify, sublicense, or distribute thè Program except as expressly provided 
under this License. Any attempt otherwise to copy, modify, sublicense or distribute thè Program is 
void, and will automatically terminate your rights under this License. However. parties who have 
received copies, or rights, from you under this License will not have their licenses terminated so 
long as such parties remain in full compliance. 

5. You are not required to accept this License, since you have not signed it. However, nothing else 
grants you permission to modify or distribute thè Program or its derivative works. These actions 
are prohibited by law if you do not accept this License. Therefore, by modifying or distributing 
thè Program (or any work based on thè Program), you indicate your acceptance of this License 
to do so, and all its terms and conditions for copying, distributing or modifying thè Program or 
works based on it. 

6. Each time you redistribute thè Program (or any work based on thè Program), thè recipient au¬ 
tomatically receives a license from thè originai licensor to copy, distribute or modify thè Program 
subject to these terms and conditions. You may not impose any further restrictions on thè recip- 
ients’ exercise of thè rights granted herein. You are not responsible for enforcing compliance by 
third parties to this License. 

7. If, as a consequence of a court judgment or allegation of patent infringement or for any other 
reason (not limited to patent issues), conditions are imposed on you (whether by court order, 
agreement or otherwise) that contradict thè conditions of this License, they do not excuse you 
from thè conditions of this License. If you cannot distribute so as to satisfy simultaneously your 
obligations under this License and any other pertinent obligations, then as a consequence you may 
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not distribute thè Program at all. For example, if a patent license would not permit royalty-free 
redistribution of thè Program by all those who receive copies directly or indirectly through you, 
then thè only way you could satisfy both it and this License would be to refrain entirely frorn 
distribution of thè Program. 

If any portion of this section is held invalid or unenforceable under any particular circumstance, 
thè balance of thè section is intended to apply and thè section as a whole is intended to apply in 
other circumstances. 

It is not thè puipose of this section to induce you to infringe any patents or other property right 
claims or to contest validity of any such claims; this section has thè sole purpose of protecting 
thè integrity of thè free software distribution System, which is implemented by public license 
practices. Many people have made generous contributions to thè wide range of software dis- 
tributed through that System in reliance on consistent application of that System; it is up to thè 
author/donor to decide if he or she is willing to distribute software through any other System and 
a licensee cannot impose that choice. 

This section is intended to make thoroughly clear what is believed to be a consequence of thè rest 
of this License. 

8. If thè distribution and/or use of thè Program is restricted in certain countries either by patents 
or by copyrighted interfaces, thè originai copyright holder who places thè Program under this 
License may add an explicit geographical distribution limitation excluding those countries, so 
that distribution is permitted only in or among countries not thus excluded. In such case, this 
License incorporates thè limitation as if written in thè body of this License. 

9. The Free Software Foundation may publish revised and/or new versions of thè General Public 
License frorn tirne to time. Such new versions will be similar in spirit to thè present version, but 
may differ in detail to address new problems or concerns. 

Each version is given a distinguishing version number. If thè Program specifìes a version nurnber 
of this License which applies to it and "any later version", you have thè option of following thè 
terms and conditions either of that version or of any later version published by thè Free Software 
Foundation. If thè Program does not specify a version number of this License, you may choose 
any version ever published by thè Free Software Foundation. 

10. If you wish to incorporate parts of thè Program into other free programs whose distribution 
conditions are different, write to thè author to ask for permission. For software which is copy¬ 
righted by thè Free Software Foundation, write to thè Free Software Foundation; we sometimes 
make exceptions for this. Our decision will be guided by thè two goals of preserving thè free 
status of all derivatives of our free software and of promoting thè sharing and reuse of software 
generally. 

NO WARRANTY 

11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO 
WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE 
LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS 
AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY 
OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED 
TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PAR- 
TICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE 
OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU 
ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 

12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRIT- 
ING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODI- 
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FY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO 
YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CON- 
SEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PRO¬ 
GRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING REN- 
DERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A 
FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN 
IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF 
SUCH DAMAGES. 

END OF TERMS AND CONDITIONS 

Appendix: How to Apply These Terms to Your New Programs 

If you develop a new program, and you want it to be of thè greatest possible use to thè public, thè 
best way to achieve this is to make it free software which everyone can redistribute and change 
under these terms. 

To do so, attach thè following notices to thè program. It is safest to attach them to thè start of each 
source file to most effectively convey thè exclusion of warranty; and each file should have at least 
thè "copyright" line and a pointer to where thè full notice is found. 

<one line to give thè program's name and a brief idea of what it does.> 
Copyright (C) 19yy <name of author> 

This program is free software; you can redistribute it and/or modify 
it under thè terms of thè GNU General Public License as published by 
thè Free Software Foundation; either version 2 of thè License, or 
(at your option) any later version. 

This program is distributed in thè hope that it will be useful, 
but WITHOUT ANY WARRANTY; without even thè implied warranty of 
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See thè 
GNU General Public License for more details. 

You should have receìved a copy of thè GNU General Public License 
along with this program; if not, write to thè Free Software 
Foundation, Ine., 675 Mass Ave, Cambridge, MA 02139, USA. 


Also add information on how to contact you by electronic and paper mail. 

If thè program is interactive, make it output a short notice like this when it starts in an interactive 
mode: 

Gnomovision version 69, Copyright (C) 19yy name of author 

Gnomovision Comes with ABSOLUTELY NO WARRANTY; for details type 'show w'. 
This is free software, and you are welcome to redistribute it 
under certain conditions; type 'show c' for details. 


The hypothetical commands ‘show w’ and ‘show c’ should show thè appropriate parts of thè 
General Public License. Of course, thè commands you use may be called something other than 
‘show w’ and ‘show c’; they could even be mouse-clicks or menu items—whatever suits your 
program. 

You should also get your employer (if you work as a programmer) or your school, if any, to sign 
a "copyright disclaimer" for thè program, if necessary. Here is a sample; alter thè names: 

Yoyodyne, Ine., hereby disclaìms all copyright interest in thè program 
'Gnomovision' (which makes passes at compilers) written by James Hacker. 

<signature of Ty Coon>, 1 Aprii 1989 
Ty Coon, President of Vice 
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This General Public License does not permit incorporating your program into proprietary pro- 
grams. If your program is a subroutine library, you may consider it more useful to permit linking 
proprietary applications with thè library. If this is what you want to do, use thè GNU Library 
General Public License instead of this License. 
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